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Preface 


Intended Audience 

This manual is intended for all users of the VAX/VMS system. 


Structure of This Document 

This document is composed of four major sections. 

The Format Section is an overview of MAIL and is intended as a quick 
reference guide. The format summary contains the DCL command that 
invokes MAIL, listing all command qualifiers and parameters. The usage 
summary describes how to invoke and exit from MAIL. The command 
summary lists all MAIL commands that can be used within MAIL. 

The Description Section explains how to use MAIL. 

The Command Section describes each MAIL command. Commands appear in 
alphabetical order. 

The Examples Section contains examples of common operations that you 
perform with MAIL. 


Associated Documents 

For introductory information about the Mail Utility, see the Introduction to 
VAX/VMS. 


Conventions Used in This Document 


Convention 

[Hf] 


|CTRL/x| 


$ SHOW TIME 
05-JUN-1985 11:55:22 

$ TYPE MYFILE.DAT 


Meaning 

A symbol with a one- to three-character 
abbreviation indicates that you press a key on 
the terminal, for example, I ret| . 

The phrase CTRL/x indicates that you must press 
the key labeled CTRL while you simultaneously 
press another key, for example, CTRL/C, CTRL/Y, 
CTRL/O. 

Command examples show all output lines or 
prompting characters that the system prints 
or displays in black letters. All user-entered 
commands are shown in red letters. 

Vertical series of periods, or ellipsis, mean either 
that not all the data that the system would display 
in response to the particular command is shown or 
that not all the data a user would enter is shown. 
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Convention 

Meaning 

file-spec,... 

Horizontal ellipsis indicates that additional 
parameters, values, or information can be entered. 

[logical-name] 

Square brackets indicate that the enclosed item 
is optional. (Square brackets are not, however, 
optional in the syntax of a directory name in a 
file specification or in the syntax of a substring 
specification in an assignment statement.) 

quotation marks 
apostrophes 

The term quotation marks is used to refer to 
double quotation marks ("). The term apostrophe 
(') is used to refer to a single quotation mark. 







New and Changed Features 


With Version 4.0 of VAX/VMS, MAIL is now a single-key ISAM file 
(SYS$SYSTEM:VMSMAIL.DAT) containing the following information for 


each user: 

Username 

Forwarding address (SET FORWARD) 

Personal name (SET PERSONAL-NAME) 

Copy SEND/REPLY flags (SET COPY_SELF) 
Autopurge flag (SET AUTO_PURGE) 

Mail file subdirectory name (SET MAIL-DIRECTORY) 
New mail count (the number of unread mail messages) 



New mail commands follow: 

ANSWER 

ATTACH 

COPY 

CURRENT 

DEFINE/KEY 

EDIT 

EXTRACT 

FIRST 

MAIL 

MOVE 

PURGE 

SEARCH 

SELECT 

SET [NO]AUTOPURGE 
SET COPY—SELF 

ccT FTT F 

SET [NO]FORWARD 

SET [NO]MAIL_DIRECTORY 

SET [NO]PERSONAL_NAME 

SET WASTEBASKET_NAME 

SHOW ALL 

SHOW AUTO_PURGE 

SHOW COPY-SELF 

SHOW FILE 

SHOW FORWARD 

SHOW MAIL-DIRECTORY 

SHOW PERSONAL-NAME 

SHOW WASTEBASKET_NAME 

SPAWN 


Changes to existing MAIL commands follow: 

• DELETE command—VAX/VMS Version 4.0 provides two ways to use the 
DELETE command. As in Version 3.0, you use the DELETE command 
to remove the message you are currently reading. Or, (new with Version 
4.0), you can enter the DELETE command followed by the number of the 
message you want to remove. 
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New and Changed Features 


• DIRECTORY command—With Version 4.0 of VAX/VMS, the 
DIRECTORY command lists a summary of all the messages in the 
current folder (instead of the current message file). The new DIRECTORY 
command can take six new qualifiers: 

/BEFORE=date 

/FOLDER 

/FULL 

/NEW 

/SINCE=date 

/START=start=point 

• FILE command—With Version 4.0 of VAX/VMS, the behavior of the 
FILE command has changed. Instead of moving a mail message to an 
outside file (where you could access it from the DCL command level), the 
FILE command now moves a mail message to another folder, keeping the 
message within MAIL. If you do want to make mail messages accessible 
outside of MAIL, use the EXTRACT command. To add a message to an 
existing file, use EXTRACT/APPEND. 

You can use the new MAIL command MOVE and the FILE command 
interchangeably. Both commands copy a mail message to the specified 
folder and delete it from the current folder. 

• FORWARD command—With Version 4.0 of VAX/VMS, the FORWARD 
command can take two new qualifiers: /EDIT and /NOHEADER. 

• HELP command—With Version 4.0 of VAX/VMS, the HELP command 
provides information about topics, such as "Folders" and "Getting Started" 
as well as detailed information (including examples) about all the available 
MAIL commands. 

• PRINT command—With Version 4.0 of VAX/VMS, the PRINT command 
can take three new qualifiers: /COPIES=n, /NOTIFY, and /PRINT. 

• READ command—With Version 4.0 of VAX/VMS, the READ command 
reads messages from the specified folder instead of the specified message 
file. Three new qualifiers can be used with the READ command: 
/BEFORE=date, /NEW, and /SINCE=date. 

• REPLY command—Version 4.0 of VAX/VMS provides two new qualifiers 
for the REPLY command: /EXTRACT and /SELF. 

• SEND command—Version 4.0 of VAX/VMS provides two new qualifiers 
for the SEND command: /SELF and /SUBJECT. 
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MAIL 


MAIL 


FORMAT 


The VAX/VMS Mail Utility (MAIL) allows you to send messages 
to other users on your system or on any other computer that is 
connected to your system by means of DECnet—VAX. You can also 
read, file, forward, delete, print, and reply to messages that other 
users send to you. 

Messages that you receive are stored in files called mail files. Your 
default mail file, called MAIL.MAI, is created in your default directory 
the first time you receive a mail message. You can create other 
mail files to accompany MAIL.MAI by using one of the following 
commands: 

• COPY 

• FILE 

• MOVE 

You can use mail files to organize mail messages. For example, you 
can create a mail file named GRADES.MAI and use it to collect mail 
messages containing information about test scores. Or, you can 
create a mail file named MEMOS.MAI and use it to collect memos. 

All mail files are subdivided into folders. For more information 
about folders, see the section on Using Folders to Organize Mail 
Messages. 


MAI L [file-spec] [recipient-name] 


Command Qualifiers Defaults 

/EDIT /NOEDIT 

/SELF /NOSELF 

/SUBJE C T= "text ” 

Command rameters 

file-spec 

Specifies the name of the file to be mailed. 
recipient-name 

Specifies the name of a user (or users) or a distribution list to which the file is 
mailed. 

When you specify a list of users, separate each name by a comma. 

When you specify a distribution list, precede the name of the list by an at 
sign (@) and enclose both the at sign and the name in quotation marks, as 
the following example shows: 

$ MAIL JOKES.DAT "OLIST" 
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MAIL 


usage summary 


commands 


Invoking 

To use MAIL interactively, enter the following command in response to the 
DCL prompt: 

$ 

The utility responds with the prompt: 

MAIL> 

Once MAIL has been invoked, you can issue any of the MAIL commands. 

Exiting 

To exit from MAIL, enter the EXIT command at the MAIL prompt. 

MAIL> 

You can also exit from MAIL by entering CTRL/Z or using the QUIT com¬ 
mand. 


Syntax 

MAIL> command [parameter] 


MAIL Commands 

ANSWER [file-spec] 

/EDIT 

/EXTRACT 

/LAST 

/[NO]SELF 

ATTACH [process-name] 
/PARENT 
BACK 
/EDIT 

COMPRESS [file-spec] 
/OUTPUT=out-f ile-spec 
COPY foldername [filename] 
/ALL 

/[NO]CONFIRM 

CURRENT 

/EDIT 

DEFINE/KEY key-name string 
/[NO]ECHO 

/[NO]IF_ST ATE=state-list 
/[NO]LOCK_ST ATE 
/[NO]LOG 

/[NO]SET_ST ATE=state 
/[NOJTERMINATE 
DELETE [message-number] 
/ALL 

DIRECTORY [foldername] 
/BEFORE=date 
/FOLDER 
/FULL 
/NEW 

/SINCE=date 
/ST ART=start-point 
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MAIL 


EDIT [filename] 

/COMMAND=ini-file-spec 

/CREATE 

/JOURNAL=jou-file-spec 

/OUTPUT=out-file-spec 

/READ 

/RECOVER 

ERASE 

EXIT 

EXTRACT file-spec 
/APPEND 
/ALL 
/MAIL 
/NOHEADER 

FILE foldername [filename] 

/ALL 

/[NOJCONFIRM 

FIRST 

/EDIT 

FORWARD 

/EDIT 

/NOHEADER 
HELP [topic] 

LAST 

/EDIT 

MAIL [file-spec] 

/[NO]EDIT 

/LAST 

/[NO]SELF 

/SUBJECT 

MOVE foldername [filename] 

/ALL 

/[NOJCONFIRM 

NEXT 

/EDIT 

PRINT 

/ALL 

/COPIES=n 

/NOTIFY 

/PRINT 

/QUEUE=queue-name 

PURGE 

/RECLAIM 

/STATISTICS 

QUIT 

READ [foldername] [message-number] 
/BEFORE=date 
/EDIT 
/NEW 

/SINCE=date 
REPLY [file-spec] 

/EDIT 

/EXTRACT 

/LAST 

/[NO]SELF 

SEARCH [search-string] 
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MAIL 

Description 



SELECT [foldername] 

/BEFORE=date 

/NEW 

/SINCE=date 

SEND [file-spec] 

/[NOJEDIT 

/LAST 

/[NOJSELF 

/SUBJECT 

SET [NO]AUTO_PURGE 

SET COPY_SELF command, [command] 

SET FILE filename 

SET FOLDER 
/BEFORE=date 
/NEW 

/SINCE=date 

SET [NO]FORWARD [_user-name],address 
/USER=user-name 

SET [NO]MAII_DIRECTORY subdirectory-name 

/LOG 

SET [NOJPERSONAI_NAME "text-string” 

SET WASTEBASKET_NAME foldername 

SHOW ALL 

SHOW AUTO_PURGE 

SHOW COPY_SELF 

SHOW DELETED 

SHOW FILE 

SHOW FOLDER 

SHOW FORWARD 

SHOW KEY 
/ALL 
/BRIEF 
/DIRECTORY 
/STATE 

SHOW MAII_DIRECTORY 

SHOW NEW—MAII_COUNT 

SHOW PERSONAL_NAME 

SHOW WASTEBASKET_NAME 

SPAWN command 
/INPUT=file-spec 

/[NO]LOGICAI_NAMES 

/OUTPUT=file-spec 

/PROCESS=subprocess-name 

/[NO]SYMBOLS 

/[NOJWAIT 

DESCRIPTION 

The following sections describe characteristics of the Mail Utility. All the 
examples displaying an editor are EDT-specific. 
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MAIL 

Description 


1 Using Folders to Organize Mail Messages 

All mail files are subdivided into folders. By default, your mail file 
(MAIL.MAI) contains a folder named MAIL. The MAIL folder contains 
messages that you have already read. When you receive new mail messages, 
they automatically enter a folder named NEWMAIL. After you read the mes¬ 
sages in the NEWMAIL folder, they automatically move into the MAIL folder. 
The NEWMAIL folder disappears after you have read all new mail messages 
and either SELECT another folder or EXIT from MAIL. 

When you delete a message it automatically moves into the WASTEBASKET 
folder. Deleted messages will collect in the WASTEBASKET folder until you 
empty it. To empty the WASTEBASKET folder, enter one of the following 
commands: 

• EXIT 

• PURGE 

You can create as many folders as you want. You can use the following 
commands to create folders: 

• COPY 

• FILE 

• MOVE 

You will always know which folder you are currently in because the name 
of the folder is displayed at the top right comer of the screen when you 
enter the READ or DIRECTORY command. You can enter the DIRECTORY 
/FOLDER command to see a display of the existing folders in the current 
mail file. You can remove a folder by deleting all the messages it contains. 

Figure MAIL-1 shows the MAIL hierarchy. The Mail Utility contains mail 
files. A mail file contains folders. A folder contains mail messages. 


2 Notification of Mail 

When MAIL sends you a message from another user while you are logged 
in (with DECnet-VAX enabled), MAIL notifies you with a message on your 
terminal as the following example shows: 

New mail on node URANUS from JAIME 

When DECnet-VAX is not enabled, MAIL displays the message without the 
node name as follows: 

New mail from JAIME 

You will also be notified that you have new mail messages when you log in 
and when you invoke MAIL: 

You have 2 new messages. 

Note: The date and time that appear on mail messages reflect the receiver's 
time, not the sender's time. 

When you transfer messages to a folder (using COPY, FILE, or MOVE) the 
messages are listed according to their time-stamp. 
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Description 


Figure MAIL-1 


MAIL Hierarchy 


• = MAIL MESSAGE 
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Using the MAIL Command Line Qualifier / EDIT 

The /EDIT qualifier allows command name keywords in the form 
/EDIT[=(keyword,keyword...)]. The allowed keywords are: 

• FORWARD 

• REPLY[=EXTRACT] 

• SEND 

You can use these keywords to set the default for MAIL. For example, to 
invoke the editor for every mail message you SEND or FORWARD, specify 
the keywords SEND and FORWARD with the MAIL/EDIT command: 

$ MAIL/EDIT=(SEND.FORWARD) 

Or, if you only want to invoke the editor when you are replying to a message, 
use the keyword REPLY with the MAIL/EDIT command. MAIL invokes the 
editor and displays a blank screen: 

$ MAIL/EDIT=(REPLY) 
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MAIL 


Description 


The REPLY keyword allows the following option: 

=EXTRACT 


When you want to reply to and edit the same message, use the REPLY 
keyword with the =EXTRACT option. MAIL invokes the editor and displays 
the message to which you are replying: 

$ MAIL/EDIT=(REPLY=EXTRACT) 


The =EXTRACT option can be used only with the REPLY keyword. 
Remember the following three items when you use the /EDIT qualifier: 

• When you do not specify a keyword with /EDIT, the default is 
/EDIT=(SEND,REPLY). 

• When you EXIT from the editor, you complete the SEND or REPLY 
operation. 

• When you want to cancel a SEND or REPLY operation, enter the QUIT 
command to exit from the editor. 





3.1 Changing the Default Editor Invoked by the /EDIT Qualifier 

When you define the logical name MAIL$EDIT, its equivalence name is used 
as the name of a command procedure that will invoke the editor. 

If MAIL$EDIT is not defined, callable EDT is invoked. 

To change the default editor for MAIL (for example, from EDT to TECO), you 
must copy the MAIL$EDIT command procedure to your directory and then 
modify it. First, enter the following command line: 

$ COPY SYS$SYSTEM:MAILEDIT.COM MAILEDIT.COM 

This copies the command that the system uses to your directory. 

Next, edit MAILEDIT.COM by changing "EDIT" to "EDIT/TECO." The 
resulting command procedure follows: 

$ !++ 

$ ! Default command procedure to invoke an editor for MAIL. 

$ ! 

$ ! Inputs: 

$ ! 

$ ! PI = Input file name 
$ ! P2 = Output file name 

$ ! 

$ ! Note that this procedure is run in the context of a subprocess, 

$ ! therefore LOGIN.COM is not executed, creator process logical 
$ ! names do not exist, and the default directory is the same as 
$ ! the creator process. 

$ ! — 

$ DEFINE/USER SYS$INPUT 'F$L0GICAL("SYS$0UTPUT")• 

$ IF PI .EQS. '"'THEN GOTO N0INPUT 
$ EDIT/TEC0/0UTPUT=•P2' 'PI' 

$ EXIT 
$ N0INPUT: 

$ EDIT/TEC0 'P2' 

Finally, enter the following line in your LOGIN.COM file: 

$ DEFINE MAILSEDIT disk:[directory]MAILEDIT.COM 

Disk is the disk on which the file is located and [directory] is your directory 
name. 
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MAIL 

Description 


4 Using the DCL Command MAIL to Send Files 

You can use a single command line to send a file to one or more users by 
specifying parameters when you enter the DCL command MAIL. When 
you use the MAIL command with parameters, the command string has the 
following format: 

$ MAIL[/SUBJECT="text"] [/SELF] file-spec recipient-name 

The "text" is the subject of the message. If you include more than one word, 
you must enclose the text in quotation marks. If you omit the /SUBJECT 
qualifier, the message is sent without a subject notation. 

The /SELF qualifier enables MAIL to send a copy of the message you are 
sending back to yourself. 

File-spec is the name of the file to be mailed. If you specify SYS$INPUT 
as the file specification, you will be prompted for the text of the message 
(without a MAIL prompt), as the following example shows: 

$ MAIL SYS$INPUT: 

To: ARMSTRONG ’ 

Enter your message below. Press CTRL/Z when complete, or CTRL/C to quit: 

The text of the message is here. 

1 CTRL/Z 1 

$ 

If you do not specify a parameter as the file specification in the command 
string, you receive the MAIL prompt, indicating interactive MAIL. No wild¬ 
card characters are allowed in the file specification. If you omit the file type, 
the default file type is TXT. 

The recipient-name is either the name of a user(s) or a distribution list 
to which the file is mailed. If you do not specify a recipient-name in the 
command string, you will be prompted. 

The default file type for a distribution list is DIS. Double quotation marks and 
an at sign (@) are required (for example, "(^distribution, dis" ). A distribution 
list name that follows one or more user name specifications must be preceded 
by a comma. 

The following command string contains one qualifier and two parameters: 

$ MAIL/SUBJECT="for your information" MEETING THOMAS.SLOAN 

• subject text "for your information" (qualifier) 

• file-spec (MEETING) (parameter) 

• usernames (THOMAS,SLOAN) (parameter) 

Because the file type was omitted, MAIL searches your default directory for 
the file MEETING.TXT. 

The following command string contains the file-spec NOTICE and listname 
@WRITERS parameters. Because the /SUBJECT qualifier was not included, 
the message is sent without a subject notation. MAIL assumes the default file 
type of TXT for the file NOTICE. 

$ MAIL NOTICE "<9WRITERS" 
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Description 


5 Using a Keypad in MAIL 

By default, all the keys on your VT100, VT52, or LK201 keypad are defined to 
execute MAIL commands. When you press a keypad key, a MAIL command 
executes. Most of the keys have two functions. To use one of the functions, 
you simply press the key. To use the other function, you press the GOLD 
key (PF1) before you press the key. 

Figure MAIL-2 displays the default key definitions for your keypad in MAIL. 

Figure MAIL-2 Default Keypad Definitions 
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For example, keypad key 5 is defined as the MAIL command FIRST. When 
you press keypad key 5, the first message in the current folder is displayed. 
The alternate function of keypad key 5 is the MAIL command FIRST/EDIT. 
So, when you press the GOLD key followed by keypad key 5, the editor is 
invoked along with the first message in the current folder. 

MAIL allows you to override the keys defined by default on your VT100, 
VT52, and LK201 keyboards. You can replace any or all of the default key 
definitions or you can just reorganize them. 
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For example, to define the key PF1 as the MAIL command DIRECTORY, 
enter the following command line: 

MAIL> DEFINE/KEY PF1 "DIRECTORY" 

After you fine PF1, you can press it to display the DIRECTORY command. 

You can use the /STATE qualifier to increase the number of key definitions 
available on your terminal. The same key can be assigned any number of 
definitions as long as each definition is associated with a different state. State 
names can be any alphanumeric string. 

For example, define key PF2 to execute the SET command, specifying a state 
named ALTERED as follows: 

MAIL> DEFINE/KEY PF2 "SET "/SET_STATE=ALTERED 

Then, define key PF3 to output the string "FILE" when the state ALTERED is 
specified as follows: 

MAIL> DEFINE/KEY PF3 "FILE" /IF_STATE=ALTERED /TERMINATE 


Use the /TERMINATE qualifier to end the command line. (When you specify 
the /TERMINATE qualifier, you can avoid pressing the RETURN key to 
execute the command line.) After you define PF2 and PF3, you can use them 
together. Press PF2 to produce the first half of the command line (SET) and 
press PF3 to finish the command line (FILE). 

Any keypad keys that you define during a MAIL session will disappear 
when you EXIT from MAIL. To retain keypad key definitions from one MAIL 
session to another, create a file in your top-level directory containing these 
key definitions (for example, MAIL$KEYDEF.INI) and enter the following 
command line in your login command file (LOGIN.COM): 

$ DEFINE MAIL$INIT SYS$LOGIN:MAIL$KEYDEF.INI 


The file you create (MAIL$KEYDEF.INI) containing your key definitions will 
act like a login command file for MAIL. You will be able to use any key that 
has been defined in the file (MAIL$KEYDEF.INI). 

The following sample MAIL$KEYDEF.INI contains six key definitions: 


DEFINE/KEY PF1 "DIRECTORY " 
DEFINE/KEY PF1 "/FOLDER" 
DEFINE/KEY PF2 "SELECT " 
DEFINE/KEY PF2 "MAIL" 
DEFINE/KEY PERIOD "READ " 
DEFINE/KEY PERIOD "/NEW" 


/NOTERMINATE 

/TERMINATE 

/NOTERMINATE 

/TERMINATE 

/NOTERMINATE 

/TERMINATE 


/SET_STATE=folder 
/IF_STATE=folder 
/SET_STATE=mai1 
/IF_STATE=mail 
/SET_STATE=new 
/IF_STATE=new 


By specifying states, you can press the same key twice (for example, PF1) 
entering a command (DIRECTORY) the first time and a qualifier (/FOLDER) 
the second time. 

For detailed information about the DEFINE/KEY command and its qualifiers, 
see the Commands Section. 
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6 Converting Mail Files 

With Version 4.0 of VAX/VMS, the file organization used by the Mail Utility 
has changed from sequential to ISAM (indexed sequential access method). 
The organization of a sequential file is different from an indexed file. In a 
sequential file, the records are processed in the order in which they were 
originally written. In an ISAM file, records are processed sequentially by an 
index. 

If you are a new VAX/VMS user, you do not need to read this section 
because you already have ISAM mail files by default. If you are upgrading 
from VAX/VMS Version 3.0 to VAX/VMS Version 4.0, follow the instructions 
in this section to convert your sequential mail files to ISAM mail files. 

The first time you invoke MAIL interactively with VAX/VMS Version 4.0, 
MAIL will convert your default mail file (SYS$LOGIN:MAIL.MAI) to an 
ISAM file. You will not be able to receive new mail during the conversion. 
When the conversion is complete, MAIL displays the following messages: 

%MAIL-I-CVTFILE, converting message file DISKSALTERED:[BURKE]MAIL.MAI;1 
to ISAM message file DISK$ALTERED:[BURKE]MAIL.MAI;2 
'/.MAIL-I-NEWFOLDER, folder MAIL created 

%MAIL-S-RENAMED. DISK$ALTERED:[BURKE]MAIL.MAI;1 renamed to DISKSALTERED:[BURKE]MAIL.OLD;1 
Press RETURN to continue> 


As the messages indicate, when the conversion of your mail file (from 
sequential to ISAM) is complete, MAIL renames the old sequential MAIL.MAI 
file to MAIL.OLD. 


You may want to convert any old or existing MAI files you created (with the 
MAIL command FILE before VAX/VMS Version 4.0) to ISAM files if you 
want to do more than READ them or display a listing of them (DIRECTORY). 

MAIL still allows you to access your old MAI files with the new SET FILE 
command. However, unless you convert your sequential files to ISAM files, 
you will not be able to use the following new MAIL commands: 


COPY 

DELETE number 

DELETE/ALL 

DIRECTORY/BEFORE 

DIRECTORY/FOLDER 

DIRECTORY/SINCE 

PURGE 

READ/BEFORE 
READ/SINCE 
SELECT 
SET FOLDER 
SET WASTEBASKET 
SHOW DELETED 
SHOW FOLDER 
SHOW WASTEBASKET 


Use the following five steps to convert sequential mail files to ISAM mail 
files. 

1 Invoke MAIL: 

$ MAIL 

MAIL> 
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2 Establish the MAI file you want to convert as the current mail file: 

MAIL> SET FILE file-to-be-converted 

3 Move all the messages from your old sequential mail file to an ISAM mail 
file: 

MAIL> COPY/ALL foldername NEWISAMFILE 

4 Establish the file named NEWISAMFILE as the current mail file: 

MAIL> SET FILE NEWISAMFILE 

5 Select the folder containing the mail: 

MAIL> SELECT foldername 


7 Sending Messages Using DECnet—VAX 

If you include a node name with the user name, the message is sent by means 
of DECnet-VAX to that user. If you omit the node name, MAIL assumes that 
the user is on your node. If you omit the node name and the user is not on 
your node, MAIL issues an error message. 

You can specify node names and user names as logical names. For example, 
if the user Arthur King is on node KAMLOT and you did not assign a logical 
name, you would have to type the following: 

To: KAMLOT::KING 

However, if you had previously made the following assignment, you could 
simply respond to the prompt with the logical name ART. 

$ DEFINE ART KAMLOT::KING 

If you frequently send messages to certain users on other nodes, you can use 
MAIL more efficiently by entering the appropriate DEFINE commands in your 
LOGIN.COM file. 

If you define a logical name for a username, you may produce a forwarding 
loop. For instance, if you define KLEE to be MYNODE::KLEE, and send mail 
to KLEE while you are logged in on MYNODE, MAIL detects a forwarding 
loop because MAIL strips the nodename when it is the same as your current 
node. To allow this kind of logical name (in a LOGIN.COM file, for example) 
and also avoid a forwarding loop, use the qualifier /TRANSLATION— 
ATTRIBUTES=TERMINAL when you define the logical name: 

$ DEFINE/TRANSLATION_ATTRIBUTES=TERMINAL KLEE MYNODE::KLEE 


8 Sending Messages To Distribution Lists 

If you frequently send mail to the same group of users, you may find it 
helpful to use a distribution list. A distribution list is a file containing the 
names and nodes of users to whom you want to send messages. 

To set up a distribution list, use the DCL command EDIT or CREATE to 
create a distribution list file with the file type DIS. Enter one user name 
per line in this file. A distribution list can also include the names of other 
distribution lists. Your open file quota determines the number of different 
nodes to which you can send mail (at one time) and the depth to which you 
can nest distribution lists. You can include comments by entering lines whose 
first character is an exclamation point (!). The following example shows how 
to create a distribution list: 
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$ CREATE WRITERS.DIS 

!SOFTWARE WRITERS: 

PIERSON 

N0DE3::JOSEPHS 

LAWRENCE 

N0DE4::ASHLEY 

!NESTED DISTRIBUTION LIST: 

OSTAFF 

To use the distribution list file, you enter its file name preceded by an at sign 
(@) in response to the To: prompt (To: @ WRITERS). You can enter separate 
user names along with the distribution list if the distribution list is the last 
entry (To: BARKER,FLECK,@ WRITERS). However, you cannot send mail to 
more than one distribution list at one time unless they are nested. Note that 
a nested distribution list must be at the end of the main distribution list file. 

MAIL delivers only one copy of the mail message to each fully translated 
user. For instance, notice how user KLEE is defined as FRED in the following 
distribution list: 

$ DEFINE FRED KLEE 
$ CREATE MY.DIS 
KLEE 

N0DE1::MARSALA 

FRED 

MARSALA 

User KLEE would receive only one copy of the message since FRED and KLEE 
are the same username. User MARSALA on NODE1 and user MARSALA on 
the current node would each receive one copy because they are on different 
nodes. 


9 MAIL Status Messages 

The VAX/VMS System Messages and Recovery Procedures Reference Manual lists 
the messages issued by MAIL and provides explanations and suggested user 
actions for these messages. 

MAIL messages are in the following form: 

%MAIL-1-IDENT, message-text 

The 1 is a severity code, either E for error, W for warning, or I for information. 
The IDENT is a mnemonic representing the specific error that occurred. The 
message-text is a brief description of the condition that caused the message to 
be issued. 


10 Protection of Mail Files 

MAIL files (for example, MAIL.MAI) are protected so that no one can read 
them, and you cannot accidentally delete them. The protection code that 
MAIL gives MAI files is: (SYSTEM:RW,OWNER:RW,GROUP:,WORLD:); that 
is, the system (including the Mail Utility itself) and the owner (you) can read 
and write to the file, and the group and world are denied all access. 

If you want information about setting and changing the protection of files, see 
the description of the SET PROTECTION command in the VAX/VMS DCL 
Dictionary. 
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System Management and MAIL 

SYS$SYSTEM:VMSMAIL.DAT is a single-key ISAM file containing the 
following information for each user: 

• Username 

• Forwarding address (SET FORWARD) 

• Personal name (SET PERSONAL-NAME) 

• Copy SEND/REPLY flags (SET COPY_SELF) 

• Autopurge flag (SET AUTO_PURGE) 

• Mail file subdirectory name (SET MAIL-DIRECTORY) 

• New mail count (the number of unread mail messages) 

The system manager can arrange mail forwarding for users without accounts 
on the system by using the SET FORWARD/USER=user command. 

The system manager can set the following flags in a user account by using 
the Authorize Utility: 

• Disnewmail—disables the display of the new mail count when the user 
logs in to the system 

• Nomail—restricts the user from receiving new mail 

If you define the logical name MAIL$SYSTEM_FLAGS using the qual¬ 
ifiers /SYSTEM and /EXECUTIVE-MODE ($ DEFINE/SYSTEM/EXEC 
MAIL$SYSTEM_FLAGS 1), then MAIL$SYSTEM_FLAGS is interpreted as a 
number in the following way: 

Command Parameters 
1 

Indicates that this node is part of a homogeneous cluster. In other words, all 
disks are accessible to the cluster and there is a common SYSUAF file and a 
common VMSMAIL file for the cluster. When this bit is set, MAIL checks to 
see if the node to which you are sending mail is currently in the cluster. If the 
node is in the cluster, MAIL bypasses using DECnet and writes directly to the 
recipient's mail file. (Note that the node must be up for MAIL to determine 
whether it is part of the cluster.) 

2 

Directs MAIL to set the cluster breakthrough flag when issuing the $BRK- 
THRU service to notify the recipient of new mail. This flag is only used in 
VAXcluster systems, and typically only in homogeneous VAXclusters (in other 
words, flag 1 is also set). 

4 

Directs MAIL to include the time the message was delivered in the notification 
message printed on the recipient's terminal. 
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Note that if MAIL$SYSTEM__FLAGS is translated to 7, MAIL selects all three 
flags. If the logical name does not translate, the default is 0. 

If the number of new (unread) mail messages displayed on your screen is 
inconsistent with the actual number of new messages, enter the READ/NEW 
command when there is no new mail. 

In MAIL messages sent via DECnet-VAX, the user can specify node names 
and user names as logical names. They are translated like VAX RMS specifi¬ 
cations: a node name or user name is translated only if it is the first string in 
the specification. Any access control information in the node name or logical 
name is ignored. 


12 What MAIL Does with Large Mail Messages 

When you receive a mail message larger than 3 blocks, it is written to a 
sequential file. You will see this mail message listed in your mail directory 
with a file type of MAI, as the following example shows. 

MAIL$nnnnnnnnnnnnimnnniinn. MAI 

MAIL deletes these MAI files from your mail directory when you delete the 
messages from within MAIL. If you delete these files outside of MAIL and 
then attempt to read the associated messages inside of MAIL, you will receive 
an error message followed by a display of the From:, To:, and Subject: fields. 

To avoid the display of these MAI files in your SYS$LOGIN directory, you 
can create a mail subdirectory. This subdirectory can then contain all your 
MAI files. 

To create a subdirectory containing all your MAI files, use the SET MAIL 
DIRECTORY command. For information about SET MAIL_DIRECTORY, see 
the Commands Section. 
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QUALIFIERS 


When invoking MAIL, you can supply the /EDIT qualifier, which modifies 
the characteristics of the utility. 
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/EDIT 

Sets the default to /EDIT for the SEND and REPLY commands. 

FORMAT 

MAIL/EDIT [=(keyword[=option],...)] 

qualifier values 

keyword 

Allowed keywords are FORWARD, REPLY, and SEND. 

option 

The EXTRACT option can be used with the REPLY keyword. 


EXAMPLES 


□ $ MAIL/EDIT 

MAIL> SEND 
To : EARTH::MAX 
Subj: Experiment 

Input file does not exist 
[EOB] 

* 

This example shows how to use the /EDIT qualifier with the MAIL command 
enabling you to edit any message you send. 

Q $ MAIL/EDIT=(REPLY.FORWARD) 

MAIL> 14 


MAIL> REPLY 

To: EARTH::MAX 

Subj: Experiment 

Input file does not exist 

[EOB] 


This example shows how to use the /EDIT qualifier specifying the keywords 
REPLY and FORWARD enabling you to edit any message you forward or to 
which you reply. 
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/SELF 

Sends a copy of the message containing the file specification on the 
command line back to you. 

FORMAT 

MAIL/SELF file-specification 


EXAMPLE 

$ MAIL/SELF experiments.dat 


This example shows how to use the /SELF qualifier to send a copy of the 
message containing the file named EXPERIMENTS.DAT back to you. 
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/SUBJECT 


Specifies the subject of the message for the heading. If the text 
consists of more than one word, enclose the text in quotation 
marks. 


FORMAT MAl L/SUBJECT="text" file-specification 


EXAMPLE 


$ MAIL/SUBJECT="Life in the Big City" file.txt 

This example shows how to use the /SUBJECT qualifier to send a file named 
FILE.TXT with a subject heading of "Life in the Big City." 
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COMMANDS 

To enter MAIL commands, first invoke MAIL and then enter the MAIL 
commands at the prompt, MAIL> . These commands can be abbreviated to a 
unique, shorter form (usually as short as one letter). Note that D is the short 
form of DELETE (not DIRECTORY) and R is the short form of REPLY (not 
READ). 

MAIL provides commands that enable you to: 

• Read and organize mail messages 

• Exchange mail messages with other users 

• Remove mail messages 

• Tailor the Mail Utility 

• Exit from MAIL or transfer control while still in MAIL 

• Make hardcopies of mail messages 

The following table lists all the available MAIL commands by functional 
category: 


Reading Messages 

Organizing Messages 

BACK 

CURRENT 

FIRST 

LAST 

NEXT 

READ 

SEARCH 

SHOW NEW_MAII_COUNT 

COPY 

DIRECTORY 

EXTRACT 

FILE 

MOVE 

SELECT 

SET FILE 

SET WASTEBASKET_NAME 


SHOW FILE 

SHOW WASTEBASKET_NAME 


Exchanging Messages 

Removing Messages 

ANSWER 

FORWARD 

MAIL 

REPLY 

SEND 

DELETE 

PURGE 

SET [NO]AUTO_PURGE 

SHOW AUTO—PURGE 


Tailoring MAIL 

Exiting or Transferring Control 
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Tailoring MAIL 

Exiting or Transferring Control 

SET [NO]COPY_SELF 

SET [NO]FORWARD 

SET [NO]MAII_DIRECTORY 

SET [NOJPERSONAI_NAME 

SHOW ALL 

SHOW COPY—SELF 

SHOW FORWARD 

SHOW MAII_DIRECTORY 

SHOW PERSONAl_NAME 

SPAWN 


Making Hard Copies of Mail Messages 


PRINT 
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ANSWER 

Sends a message to the sender of the message you are currently 
reading or the one you last read. If you do not specify the name of 
a file to be sent as your reply, you will be prompted for the text of 
your reply. 

You can use the ANSWER command and the REPLY command 
interchangeably because they work the same way. 

You must be reading a message in order to answer it. 

FORMAT 

ANSWER [file-spec] 

command 

parameter 

file-spec 

Indicates the name of the file to be sent as a reply. 

command 

qualifiers 

/[NOJEDIT 

Invokes the EDT editor to edit the reply you are sending. When you EXIT 
from EDT the edited message is sent. To cancel the sending of the mes¬ 
sage, enter the EDT command QUIT. If you enter the DCL command 
MAIL/EDIT=(REPLY) and then decide that you do not want to invoke 
the editor for your response, enter the MAIL command REPLY/NOEDIT. 

/EXTRACT 

Invokes the EDT Editor to enable you to edit the current message to which 
you are replying. 

/LAST 

Specifies that the last message you sent be used as text for the reply. The 
only qualifier you can use with /LAST is /SELF. 

/[NOJSELF 

Determines whether MAIL sends a copy of the response back to you. The 
default is /NOSELF, unless you have used the SET COPY—SELF command 
to specify that copies be sent to yourself automatically. 


EXAMPLES 

Q MAIL> ANSWER 

To: AUTUMN::GREGG 
Subj : RE:Nova Scotia 

Enter your message below. Press CTRL/Z when complete, or CTRL/C to quit: 

This example shows how to use the ANSWER command to respond to a 
message sent by a user named Gregg on node AUTUMN. 
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0 MAIL> ANSWER/EDIT 

To: ARCTIC::SWENSON 
Subj: RE:SIAM 
[EOB] 


This example shows how to use the /EDIT qualifier with the ANSWER 
command to respond to a message from a user named Swenson on node 
ARCTIC. When using the EDT editor, the end-of-buffer ([EOB]) sign will 
move down the screen as you enter text. 
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ATTACH 

Permits you to switch control of your terminal from your current 
process to another process in your job. 

The ATTACH command allows you to move quickly between pro¬ 
cesses that you have created with the SPAWN command. For 
example, while you are editing a file, you can SPAWN a subprocess 
(MAIL) to read a new mail message. Then, you can ATTACH back 
to the editing session. If you want to read another new mail mes¬ 
sage, you can ATTACH back to the MAIL subprocess you already 
created. 

FORMAT 

ATT AC H process-name 

command 

parameter 

process-name 

Indicates the name of the subprocess to which the connection is to be made. 

command 

qualifier 

/PARENT 

Indicates that you want to attach to the parent process of your current 
process. If no parent process exists, an error message is displayed. You 
cannot specify the process-name parameter with the /PARENT qualifier. 


EXAMPLE 

$ EDIT VACATION.TXT 

I CTRL/Y | 

$ SPAWN MAIL 

7.DCL-S-SPAWNED, process MAGNANI.l spawned 

7.DCL-S-ATTACHED, terminal now attached to process MAGNANI.l 
MAIL> READ 

MAIL> ATTACH MAGNANI 

7.DCL-S - RETURNED, control returned to process MAGNANI 


ICTRL/Y 1 

$ ATTACH MAGNANI.l 

MAIL> 

This example shows how to SPAWN a subprocess (MAGNANL_1) to 
invoke MAIL and use the ATTACH command to move between MAIL 
(MAGNANL_1) and the DCL command level (MAGNANI). The ATTACH 
command allows you to transfer control between subprocesses. 


Note: You always SPAWN a new process and ATTACH to a process that already 
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BACK 



Displays the message preceding the current or last-read message 
when the last command issued was READ. When the last command 
issued was DIRECTORY, the BACK command displays the preceding 
screen of the directory listing. 

FORMAT 

BACK 

command 

parameters 

command 

qualifier 

None. 

/EDIT 

Indicates that the EDT editor is invoked. You can use the EDT editor to easily 
peruse the previous message. When you are done, enter the EDT command 
QUIT. You will see the mail prompt. If you decide to edit the message and 
want to keep a copy of the newly edited message, enter the EDT command 
EXIT and supply a file name. 
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COMPRESS 


Makes an ISAM mail file smaller. 

When you compress a file, the following four steps occur: 

1 A temporary file named MAII_nnnn_COMPRESS.TMP is created. 

(nnnn is a unique, four-digit number.) 

2 The contents (of the file to be compressed) are copied to the 
temporary file and compressed. 

3 The original (uncompressed) file is renamed with a file type of 
OLD. 

4 The newly compressed file is renamed from 

MAII_nnnn_COMPRESS.TMP back to its original name. 


FORMAT COMPRESS [file-spec] 


command file-spec 

parameter The name of the mail file to be compressed. If a file-spec is not specified, 

MAIL will compress the mail file that is currently open. If there is no open 
mail file, MAIL will compress the default mail file. 


command /OUTPUT=out-file-spec 

qualifier The name of the compressed file. 


EXAMPLES 


□ $ MAIL 

MAIL> COMPRESS 

*/,MAIL-S-CREATED, DISK$FUN:[FELLINI]MAIL_08C8_C0MPRESS.TMP;1 created 
•/.MAIL-S-COPIED, DISK$FUN: [FELLINI]MAIL.MAI; 1 copied to DISK$FUN: [FELLINI] 
MAIL_08C8_C0MPRESS.TMP;1 (2 records) 

*/,MA I L-S-RENAMED, DISK$FUN: [FELLINI] MAIL. MAI; 1 renamed to DISK$FUN: [FELLINI] 
MAIL.OLD;2 

'/.MAIL-S-RENAMED, DISKSFUN: [FELLINI]MAIL_08C8_C0MPRESS.TMP; 1 renamed to 
DISK$FUN: [FELLINI] MAIL. MAI; 1 


This example shows how to compress the contents of your default mail file 
(MAIL.MAI). 

2 MAIL> COMPRESS trips.mai 

‘/.MAIL-S-CREATED. DISKSFUN: [FELLINI] MAIL_08C8_C0MPRESS . TMP; 1 created 
•/.MAIL-S-COPIED, DISKSFUN: [FELLINI] TRIPS. MAI; 1 copied to DISKSFUN : [FELLINI] 

MAIL_08C8_C0MPRESS.TMP;1 (2 records) 

•/.MAIL-S-RENAMED, DISKSFUN: [FELLINI]TRIPS .MAI; 1 renamed to DISKSFUN: [FELLINI] 

TRIPS.OLD;2 

•/.MAIL-S-RENAMED. DISKSFUN: [FELLINI]MAIL_08C8_C0MPRESS.TMP; 1 renamed to 
DISKSFUN:[FELLINI]TRIPS.MAI;1 


This example shows how to compress the contents of a file named 
TRIPS.MAI. 
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COPY 

Copies a message to another folder without deleting it from the 
current folder. If the specified folder does not exist, it is created. 

If you want to copy a message to a sequential file (outside of MAIL) 
instead of to a mail file, use the EXTRACT command. 

If you enter the COPY command, press RETURN, supply a fold- 
ername at the prompt, and then decide (before pressing RETURN 
again) that you do not want to copy the message, enter CTRL/C. 
CTRL/C will abort the operation and keep you within MAIL. 

FORMAT 

COPY foldername [filename] 

command 

parameters 

foldername 

Indicates the name of the folder to which the message is to be copied. If 
the specified folder does not exist (and you have not entered the qualifier 
/NOCONFIRM), you are asked whether you want to create it. If you respond 
with "y," the new folder is created. A folder name can be 1 to 39 characters 
in length. Valid characters for folder names are A through Z, a through z, 
dollar sign ($), underscore (_), and 0 through 9. 

filename 

Indicates the name of the mail file to which the message is to be copied. If 
the specified mail file does not exist, it is created. If a file name is omitted, 
the message is copied to the specified folder in the current file. 

command 

qualifiers 

/ALL 

Indicates that all the currently selected messages are to be copied to another 
message folder. You select a folder by entering the SELECT command 
followed by the name of the folder. (See the SELECT command for more 
information.) If the /ALL qualifier is omitted, only the current message is 
copied. 

/[NOJCOIMFIRM 

Determines whether you will be queried about creating a new folder. The 
default is /CONFIRM. 

EXAMPLES 


Q MAIL> 2 

MAIL> COPY 
.Folder: MEMOS 
.File: [RET] 

MAIL> 

This example shows how to put a copy of a mail message into another folder 
(MEMOS) in the default mail file. 
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0 MAIL> DIRECTORY 


# 

From 

Date 

1 

MARK 

29-N0V-1985 

2 

GRIM 

3-DEC-1985 

3 

KATE 

7-DEC-1985 


MAIL> 2 

MAIL> COPY 
_Folder: TALES 
.File: [RET] 

MAIL> SELECT TALES 


MAIL 

Subj ect 

Upcoming Meetings 

Horror Stories 

Getting a Court for Fridays 


'/.MAIL-1-SELECTED. 1 message selected 


MAIL> DIRECTORY 

# From Date Subject 

1 GRIM 3-DEC-1985 Horror Stories 


TALES 



This example shows how to put a copy of a mail message (from a user named 
GRIM) into another folder (TALES) and move to that folder to see the copy 
of the mail message. 


0 MAIL> 3 

MAIL> COPY 
.Folder: TENNIS 
.File: SPORTS 

Folder TENNIS does not exist. 

Do you want to create it (Y/N. default is N)? y 
7.MAIL-S-CREATED, DISK$ATEX: [MCFEE] SPORTS .MAI; 1 created 
%MAIL-I-NEWFOLDER, folder TENNIS created 

MAIL> SET FILE SPORTS 
MAIL> DIRECTORY/FOLDER 

Listing of folders in DISK$ATEX:[MCFEE]SPORTS.MAI;1 

Press CTRL/C to cancel listing 

TENNIS 

mail> set file mail 

MAIL> DIRECTORY 


m 


This example shows how to put a copy of a mail message into a new folder 
(TENNIS) in a new mail file (SPORTS), move to the new file, and move back 
to the default mail file (MAIL.MAI). 
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CURRENT 



Displays the beginning of the message you are currently reading. If 
you are reading a long mail message and want to display the first 
part of the message again, you can enter the CURRENT command. 

FORMAT 

CURRENT 

command 

parameters 

None. 

command 

qualifier 

/EDIT 

Indicates that the EDT editor is invoked. You can use the EDT editor to easily 
peruse the current message. When you are done, enter the EDT command 
QUIT. You will see the mail prompt. If you decide to edit the message and 
want to keep a copy of the newly edited message, enter the EDT command 
EXIT and supply a file name. 
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DEFINE/KEY 

Defines a key to execute a MAIL command. This enables you to 
press a key to enter a command instead of typing the command 
name. 


FORMAT DEFINE/KEY key-name string 


command key-name 

parameters Specifies the name of the key you are defining. Use the following key-names 

when defining keys: 


Key-name 

VT100 

VT52 

LK201 

PF1 

PF1 

red key 

PF1 

PF2 

PF2 

blue key 

PF2 

PF3 

PF3 

black key 

PF3 

PF4 

PF4 

- 

PF4 

KPO, KP1-KP9 

keypad 0-9 

keypad 0-9 

keypad 0-9 

PERIOD 

period key 

period key 

period key 

COMMA 

comma key 

comma key 

comma key 

MINUS 

minus key 

minus key 

minus key 

ENTER 

ENTER key 

ENTER key 

ENTER key 

E1,E2 

- 

- 

Find,Insert Here 

E3,E4 

- 

- 

Remove,Select 

E5 

- 

- 

Previous Screen 

E6 

- 

- 

Next Screen 

HELP,DO 

- 

- 

Help(15), Do(16) 

F17-F20 

- 

- 

Function Keys 


Note: You cannot redefine the arrow keys or the function keys 1 through 14. 

string 

Specifies the string you want entered when you press the defined key. 
"String" can be a MAIL command, for example, DIRECTORY or SET FILE. 


command /[NO]EC HO 

qualifiers Specifies whether the command line is echoed after you press the defined key. 

You cannot define a key specifying both /NOECHO and /NOTERMINATE. 
The default is /ECHO. 

/[NOJIFSTA TE=state-list 

Specifies a list of states, any one of which must be set in order to enable the 
specified key definition. If you omit or negate this qualifier, the current state 
prevails. 
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/[NOJLOCK—STA TE 

Retains the state specified by the /SET_STATE qualifier until you use the 
/SET__STATE qualifier again to change it. The default is /NOLOCK_STATE. 

/[l\IO]LOG 

Specifies whether informational messages are displayed. These messages 
signal successfully created key definitions. The default is /LOG. 

/[NOJSET—S TA TE=state 

Associates a state with the key you are defining. A state name can be any 
alphanumeric string. If you omit or negate this qualifier, the current state 
remains unchanged. You cannot define a key specifying both /SET_STATE 
and /TERMINATE. 

/[NOJTERMINA TE 

Determines whether the specified command string executes when you press 
the key. When you use /NOTERMINATE, you must press RETURN to 
execute the command string. You cannot define a key specifying both 
/SET—STATE and /TERMINATE. 


EXAMPLES 

□ MAIL> DEFINE/KEY PF1 "DIRECTORY" 

This example shows how to define the keypad key PF1 as the MAIL com¬ 
mand DIRECTORY. To enter the DIRECTORY command, press PF1 followed 
by the RETURN key. 

B MAIL> DEFINE/KEY KP6 "EDIT" /TERMINATE 

This example shows how to define the keypad key 6 as the EDIT command. 
The /TERMINATE qualifier causes the EDIT command to execute when you 
press keypad key 6 without having to press RETURN. 

E MAIL> DEFINE/KEY COMMA "EXIT" 

This example shows how to define the comma key on the keypad as the EXIT 
command. Because the qualifier /TERMINATE was not specified, the default, 
/NOTERMINATE is in effect. To enter the EXIT command, press the comma 
key followed by the RETURN key. 

Q MAIL> DEFINE/KEY MINUS "SEND" /TERMINATE /NOECHO 

This example shows how to define the minus key on the keypad as the 
SEND command. The /TERMINATE qualifier causes the SEND command to 
execute when you press the minus key without having to press RETURN. The 
/NOECHO qualifier prevents the display of the command line on the screen. 
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MAIL 

DEFINE/KEY 


B MAIL> DEFINE/KEY PF4 "SET " /SET_STATE=ALTERED 

MAIL> DEFINE/KEY KP7 "FILE" /TERMINATE /IF_STATE=ALTERED 
MAIL> DEFINE/KEY KP8 "FORWARD" /TERMINATE /IF_STATE=ALTERED 
MAIL> DEFINE/KEY KP9 "WASTEBASKET" /TERMINATE /IF_STATE=ALTERED 

This example shows how to define four different keys and associate them 

with a state named ALTERED: 

1 The first definition defines the key PF4 as the SET command and asso¬ 
ciates this key with a state named ALTERED. 

2 The second definition defines the keypad key 7 to "FILE" and makes it 
dependent on a state named ALTERED. When you press PF4 followed by 
keypad key 7, MAIL executes the SET FILE command. 

3 The third definition defines keypad key 8 to "FORWARD" and also makes 
it dependent on the ALTERED state. When you press PF4 followed by 
keypad key 8, MAIL executes the SET FORWARD command. 

4 The fourth definition defines keypad key 9 to "WASTEBASKET" and also 
makes it dependent on the ALTERED state. When you press PF4 followed 
by keypad key 9, MAIL executes the SET WASTEBASKET command. 
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MAIL 

DELETE 


DELETE 

Deletes either the message you are currently reading or t message 
you just read and moves it to the WASTEBASKET folder. 


When you enter the EXIT or PURGE commands, your WASTEBAS¬ 
KET folder empties automatically. 


To recover a message accidentally deleted (while it is still in the 
WASTEBASKET folder), SELECT the WASTEBASKET folder, READ 
the desired message, and MOVE it to another folder. 

FORMAT 

DELETE [message-number] 

command 

parameter 

message-number 

Deletes the message specified by its number instead of the current message. 

command 

qualifier 

/ALL 

Deletes all the currently selected messages. You select a folder by entering 
the SELECT command followed by the name of the folder. (See the SELECT 
command for more information.) 


EXAMPLES 


Q MAIL> DIRECTORY 

MAIL 


From 

Date 

Subj ect 

MOON 

11-APR-1985 

Asteroids 


MARK 

11-APR-1985 

The 

Yen 

MARK 

11-APR-1985 

The 

Buck 


MAIL> 5 
MAIL> DELETE 
MAIL> 6 
MAIL> DELETE 

mail> directory 

MAIL 

# From Date Subject 

1 MOON 11-APR-1985 Asteroids 


5 (Deleted) 

6 (Deleted) 

This example shows how to delete two messages from the MAIL folder. 

g MAIL> DELETE 24 
MAIL> 


This example shows how to delete message number 24 by entering its 
message-number after the DELETE command. 
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MAIL 

DIRECTORY 


DIRECTORY 



Displays a list of the messages in the current mail file, including 
message number, sender's name, date, and subject. 

If "foldername" is omitted, MAIL displays a directory of the cur¬ 
rently selected messages. Every time you use /BEFORE, /NEW, 
or /SINCE, you create a new set of selected messages. If there 
are no currently selected messages, MAIL displays a directory of 
the messages in the NEWMAIL folder (if unread messages exist) or 
the MAIL folder. (See the SELECT command for information about 
selecting messages.) 

FORMAT 

DIRECTORY [foldername] 

command 

parameter 

foldername 

Indicates the name of the folder containing the messages you want to display. 

command 

qualifiers 

/BEFORE=date 

Displays a listing of all the mail messages received before the specified date. 

If no date is specified, a listing of all the mail messages received before the 
current day ("today" ) is displayed. 

/FOLDER 

Displays a listing of all the folders contained in the current mail file. 

/FULL 

Displays the number of records in the message and whether you have replied 
to the message. External message identification numbers (for messages larger 
than 3 blocks) are also displayed. 

/NEW 

Displays a listing of any new (unread) mail messages. When there are no 
unread messages, MAIL displays the message "No new messages." 

/SINCE=date 

Displays a listing of all the mail messages received on or after the specified 
date. If no date is specified, a listing of all the mail messages received on the 
current day ("today" ) is displayed. 

/S TART=start-point 

Indicates the first message number you want to display. For example, to 
display all the messages beginning with number three, enter the command 
line DIRECTORY/START=3. Use the /START qualifier with the /FOLDER 
qualifier to indicate the first folder name you want to display. For example, 
to display all the folder names alphabetically following PLEAT, enter the 
command line DIRECTORY/START=PLEAT/FOLDER. 
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MAIL 

DIRECTORY 


EXAMPLES 

Q MAIL> DIRECTORY 

MAIL 


# 

From 

Date 

Subject 

1 

MARK 

11-APR-1985 

The Yen 

2 

MARK 

11-APR-1985 

The Buck 

3 

BILL 

13-APR-1985 

The Pound 

4 

BILL 

13-APR-1985 

The Dollar 

5 

BILL 

14-APR-1985 

The Cent 

6 

MARK 

17-APR-1985 

The Dime 




This example shows how to display a listing of all the messages in the current 
folder by using the DIRECTORY command. 


MAIL> DIRECT0RY/SINCE=13-APR 


# 

From 

Date 

Subj ect 

1 

BILL 

13-APR-1985 

The 

Pound 

2 

BILL 

13-APR-1985 

The 

Dollar 

3 

BILL 

14-APR-1985 

The 

Cent 

4 

MARK 

17-APR-1985 

The 

Dime 


MAIL 


This example shows how to use the /SINCE qualifier with the DIRECTORY 
command to display a listing of all the mail messages in the current folder 
received on or after April 13, 1985. 

E MAIL> DIRECTORY/FOLDER 

Listing of folders in DISKS:[BACON]MAIL.MAI;1 
Press CTRL/C to cancel listing 
MAIL NEW.HIRES 

PROJECTS SALES.LEADS 

This example shows how to display a listing of all the folders in the current 
mail file. 

Q MAIL> DIRECTORY/FOLDER/START=P 

Listing of folders in DISKS:[BACON]MAIL.MAI;1 
Press CTRL/C to cancel listing 
PROJECTS SALES.LEADS 


This example shows how to display an alphabetical listing of all the folders in 
the current mail file beginning with the letter P. 
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MAIL 

EDIT 


EDIT 



Invokes the EDT editor, enabling you to edit a message before you 
send it. See the Guide to Text Processing on VAX/VMS and the 
VAX EDT Reference Manual for information about the EDT editor. 

FORMAT 

EDIT [filename] 

command 

parameter 

filename 

Indicates the name of the file you want to edit. 

command 

qualifiers 

/COMMA ND=ini-file-spec 

Indicates the name of an EDT startup command file (EDTINI) for 
"ini-file-spec." If you do not specify a startup command file for // ini-file-spec/ , 
the default EDTINI.EDT file set up for the DCL EDIT command takes effect. 

/CREATE 

Tells MAIL to create a file. MAIL prompts you for a file name when you do 
not specify one on the EDIT command line. 

/JOURNA L=jou-file-spec 

Specifies "jou-file-spec" as the name of the journal file. 

/OUTPUT=out-file-spec 

Specifies "out-file-spec" as the name of the output file. 

/READ 

Indicates that a journal file or output file will not be created. If you do not 
specify an existing file with the /READ qualifier, MAIL displays "Input file 
does not exist" and returns the MAIL> prompt. When you use the /READ 
qualifier, enter the QUIT command to exit from EDT. If you enter the EXIT 
command, you are prompted for a file specification. 

/RECOVER 

Indicates that you want to recover a previous editing session that was prema¬ 
turely aborted. 
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MAIL 

EDIT 


EXAMPLES 

Q MAIL> EDIT/COMMAND=EDTFUN.EDT FILENAME.DAT 

1 This is the first line of text in FILENAME.DAT. 

[EOB] 

* 


* EXIT 

DISK$MEGAWORK:[BURTON]FILENAME.DAT;1 13 lines 
MAIL> 



2 


This example shows how to invoke the EDT editor and execute the commands 
in an EDT startup command file named EDTFUN.EDT to edit an already 
existing file named FILENAME.DAT before sending it. 

mail> edit/output=other.dat 

.File: ORIGINAL.DAT 

1 This is the first line of text in a file called ORIGINAL.DAT. 


* EXIT 

DISK$FINEWORK:[DUTZ]OTHER.DAT;1 23 lines 
MAIL> 



2 


This example shows how to use the /OUTPUT qualifier to specify a name 
for the output file (OTHER.DAT) that is different from the input file (ORIGI¬ 
NAL.DAT). 


MAIL> EDIT/READ 
.File: EXISTS.TXT 


* QUIT 


This example shows how to use the /READ qualifier with the EDIT command 
and exit with the QUIT command. 
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MAIL 

ERASE 


ERASE 



Allows you to clear your screen. 

FORMAT 

ERASE 

command 

parameters 

command 

qualifiers 

None. 

None. 
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MAIL 

EXIT 


EXIT 



Allows you to exit from MAIL. You can also exit from MAIL by 
pressing CTRL/Z. When you enter the EXIT command, any mes¬ 
sages in the WASTEBASKET folder are deleted unless you have 
issued the command SET NOAUTO_PURGE. 

FORMAT 

EXIT 

command 

parameters 

command 

qualifiers 

None. 

None. 
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MAIL 

EXTRACT 


EXTRACT 



Places a copy of the current message into a sequential file. If you 
want to copy a mail message to a folder in an ISAM mail file, use 
one of the following commands: 

• COPY 

• FILE 

• MOVE 

FORMAT 

EXTRACT file-spec 

command 

parameter 

file-spec 

Specifies the name of the output file to which the message is copied. The 
default file type is TXT. By default, the device and directory will match your 
current default device and directory. 

command 

qualifiers 

/ALL 

Copies all the currently selected messages to the specified file. Each message 
will be separated by a form feed. 

/APPEND 

Adds the selected message to the end of the specified file. If the file does not 
exist, it is created. When you do not specify /APPEND, MAIL creates a new 
sequential file. 

/MAIL 

Specifies that the output file be a sequential mail file with a default file type 
of MAI and a protection code of (S:RW,0:RW,G,W). By default, the device 
and directory will match those of your mail file directory. Like /APPEND, 
/MAIL adds the selected message to the end of the specified file. 

/NOHEADER 

Removes the header information (To: From: Subject:) from the mail message. 


MAIL-40 









MAIL 

EXTRACT 


EXAMPLES 

Q MAIL> DIRECTORY 

MAIL 

# From Date Subject 

5 JOAN 12-MAR-86 Spelling Tests 

MAIL> 5 

MAIL> EXTRACT GRAMMAR 
MAIL> EXIT 
$ DIRECTORY 

GRAMMAR.TXT;1 

This example shows how to place a copy of a mail message in a sequential 
file named GRAMMAR.TXT. 

0 MAIL> EXTRACT/ALL/NOHEADER 
.File: OUTER.DAT 

•/.MAIL-1-CREATED. DISK$MEGAWORK: [CROWN] OUTER. DAT; 1 created 
MAIL> 


This example shows how to place a copy of all the messages in the currently 
selected folder into a sequential file called OUTER.DAT. The /NOHEADER 
qualifier prevents the header information from being copied. 
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FILE 


FILE 



Moves the current message to the specified folder. You can use the 
FILE command and the MOVE command interchangeably because 
they work the same way. (Note that the FILE command deletes the 
message from the original folder, unlike the COPY command, which 
leaves a copy.) 

If you enter the FILE command, press RETURN, supply a foldername 
at the prompt, and then decide (before pressing RETURN again) that 
you do not want to file the message, enter CTRL/C. CTRL/C will 
abort the operation and keep you within MAIL. 

FORMAT 

FILE foldername [filename] 

command 

parameters 

foldername 

Indicates the name of the folder to which the current message is to be moved. 
If the specified folder does not exist, you are asked whether you want to 
create it. If you respond with "y," the new folder is created. 

A folder name can be 1 to 39 characters in length. Valid characters for folder 
names are A through Z, a through z, dollar sign ($), underscore (_), and 0 
through 9. 

filename 

Indicates the name of the mail file to which the current message is to be 
moved. If the file name is omitted, the message is moved to the specified 
folder in the current file. 

command 

qualifiers 

/ALL 

Moves all the messages in the current folder to the specified folder. 

/[NOJCOIMFIRM 

Determines whether you will be queried about creating a new folder. The 
default is /CONFIRM. 
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MAIL 

FILE 


EXAMPLE 


MAIL> 2 

MAIL> FILE O 
.Folder : WIN NERS © 

.FILE: [RETl © 

Folder WINNERS does not exist. 

Do you want to create it (Y/N, default is N)? y 
7.MAIL-I-NEWF0LDER, folder WINNERS created 
MAIL> SELECT WINNERS © 

•/.MAIL-1-SELECTED, 1 message selected 
MAIL> DIRECTORY © 

# From Date Subj ect 


WINNERS 


1 BURK 18-APR-1985 


Early American Art 


MAIL> 


O Enter the FILE command to move the current message to a new folder. 

© Specify a name for the new folder. 

© Press RETURN to retain the default file. 

© To move to the new folder, enter the SELECT command followed by the 
name of the new folder (WINNERS). 

© Enter the DIRECTORY command to see the transferred message in the 
newly created folder (WINNERS). 

This example shows how to FILE a message in a new folder named WIN¬ 
NERS. 
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MAIL 

FIRST 


FIRST 



Displays the first message in the current folder. 

FORMAT 

FIRST 

command 

parameters 

None. 

command 

qualifier 

/EDIT 

Indicates that the EDT editor is invoked. You can use the EDT editor to easily 
peruse the first message. When you are done, enter the EDT command QUIT. 
You will see the mail prompt. If you decide to edit the message and want to 
keep a copy of the newly edited message, enter the EDT command EXIT and 
supply a file name. 
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MAIL 

FORWARD 


FORWARD 

Sends a copy of the message you are currently reading (or have just 
read) to a user or users. MAIL prompts you for the name of the user 
or users to whom you want to forward the message. 


If you change your mind about forwarding a message after you have 
already entered the FORWARD command, enter CTRL/C to abort 
the message. The MAIL> prompt will be displayed. 

FORMAT 

FORWARD 

command 

parameters 

None. 

command 

qualifiers 

/EDIT 

Determines whether the EDT editor is invoked to edit the message you are 
forwarding. 


/NOHEADER 

Enables you to forward a message without the original header information 
supplied from the user that sent it. The default is /HEADER. 


EXAMPLES 


Q MAIL> 3 

From: PRESTON 

To: MARLEY 

Subj: Snakes 

Beasts, under the earth, crawling... 
MAIL> FORWARD/NOHEADER 
To: SOUND::BURTON 
Subj: Snakes Again 


MAIL> READ 

From: MARLEY 

To: SOUND::BURTON 

Subj: Snakes Again 

Beasts, under the earth, crawling... 

This example shows how to forward a message to a user (SOUND::BURTON) 
without the original header information (From: PRESTON, To.MARLEY, 
Subj: Snakes). 

0 MAIL> 7 

MAIL> FORWARD/EDIT 

To: FOLEY 

Subj: The Thatched Roof 

(The text of mail message 7 is displayed here, ready to be edited.) 

This example shows how to edit a mail message before forwarding it by using 
the FORWARD/EDIT command. 
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MAIL 

HELP 


HELP 



Allows you to obtain information about the Mail Utility. 

To obtain information about all of the MAIL commands, enter the 
following command: 

MAIL> HELP * 

To obtain information about individual commands or topics, enter 
HELP followed by the command or topic name. 

FORMAT 

HELP [topic] 

command 

parameter 

topic 

Indicates a topic about which you want information. To display the list of 
available topics, enter the HELP command at the MAIL prompt. 

command 

qualifiers 

None. 
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LAST 


LAST 



Displays the last message in the current folder. 

FORMAT 

LAST 

command 

parameters 

command 

qualifier 

None. 

/EDIT 

Indicates that the EDT editor is invoked. You can use the EDT editor to easily 
peruse the last message. When you are done, enter the EDT command QUIT. 
You will see the mail prompt. If you decide to edit the message and want to 
keep a copy of the newly edited message, enter the EDT command EXIT and 
supply a file name. 
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MAIL 


MAIL 



Sends a message to another user(s). The MAIL command works 
like the SEND command. 

MAIL prompts you first for the name of the user(s) to receive the 
message. You reply with the user name(s) or with the file name of a 
distribution list file, in the following format: 

[ [nodename::]username,...] [,] [Qlistname] 

Next, MAIL prompts you for the subject of the mail message. To 
avoid the "Subj:” prompt, specify the /SUBJECT qualifier with the 
MAIL command. 

You can include a file specification with the MAIL command. If you 
specify a file with the MAIL command, the text in that file is sent to 
the specified user(s). If you do not specify a file, MAIL prompts you 
for the text of your message. 

Enter the message that you want to send; then press CTRL/Z. Note 
that once you have typed a line and pressed RETURN, there is no 
way to edit it. If you decide not to send a message you are typing 
but want to stay within the Mail Utility, press CTRL/C to abort the 
message. You will then receive the MAIL> prompt. CTRL/Y exits 
you from MAIL. 

FORMAT 

MAIL [file-spec] 

command 

parameter 

file-spec 

Indicates the name of the file to be sent. 

command 

qualifiers 

/[NOJEDIT 

Determines whether the EDT editor is invoked to edit the message you are 
sending. The /NOEDIT qualifier overrides the MAIL/EDIT default if you 
entered the DCL command MAIL/EDIT. 

You cannot specify the /EDIT qualifier with the /LAST qualifier. 

/LAST 

Specifies that the last message that you sent be used as the text for the 
message you are currently sending. 

/[NO]SELF 

Determines whether MAIL sends a copy of the message you are sending back 
to yourself. The /NOSELF qualifier overrides the SET COPY_SELF MAIL 
command. 

/SUBJECT^"subject-text" 

Specifies the subject of the mail message to be sent. 
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EXAMPLE 

MAIL> MAIL 
To: TERA:.LINDEN 
Subj: Vacation 
Enter your message 


MAIL 

MAIL 


below. Press CTRL/Z when complete, or CTRL/C to quit: 

This example shows how to use the MAIL command to send a message to a 
user named Linden on node TERA. 
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MAIL 

MOVE 


MOVE 



Moves the current message to the specified folder. You can use the 
MOVE command and the FILE command interchangeably because 
they work the same way. (Note that the FILE command deletes the 
message from the original folder, unlike the COPY command, which 
leaves a copy.) 

If you enter the MOVE command, press RETURN, supply a fold- 
ername at the prompt, and then decide (before pressing RETURN 
again) that you do not want to move the message, enter CTRL/C. 
CTRL/C will abort the operation and keep you within MAIL. 

FORMAT 

MOVE foldername [filename] 

command 

parameters 

foldername 

Indicates the name of the folder to which the current message will be moved. 
If the specified folder does not exist, you are asked whether you want to 
create it. If you respond with "y," the new folder is created. 

A folder name can be 1 to 39 characters in length. Valid characters for folder 
names are A through Z, a through z, dollar sign ($), underscore (_), and 0 
through 9. 

filename 

Indicates the name of the mail file to which the current message will be 
moved. If the specified file does not exist, it is created. If the file name is 
omitted, the message is moved to the specified folder in the current file. 

command 

qualifiers 

/ALL 

Moves all the currently selected messages to the specified folder. 

/[NOJCOIMFIRM 

Determines whether you will be queried about creating a new folder. The 
default is /CONFIRM. 
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MAIL 

MOVE 


EXAMPLE 


MAIL> 2 

MAIL> MOVE O 
.Folder : WIN NERS © 

.File: l~RETl © 

Folder WINNERS does not exist. 

Do you want to create it (Y/N, default is N)? y 
‘/.MAIL-1-NEWFOLDER, folder WINNERS created 

MAIL> SELECT WINNERS © 


•/.MAIL-1-SELECTED, 1 message selected 
MAIL> DIRECTORY © 

WINNERS 

# From Date Subject 

1 BURK 18-APR-1985 Early American Art 

MAIL> 


© Enter the MOVE command to transfer the current message to a new 
folder. 

© Specify a name for the new folder. 

© Press RETURN to retain the default file. 

© To move to the new folder, enter the SELECT command followed by the 
name of the new folder (WINNERS). 

© Enter the DIRECTORY command to see the transferred message in the 
newly created folder (WINNERS). 

This example shows how to MOVE a message to a new folder named WIN¬ 
NERS. 
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MAIL 

NEXT 


NEXT 



Skips to the next message and displays it. This command is useful 
if, while reading through your messages, you encounter a long 
message that you would like to skip over. 

FORMAT 

NEXT 

command 

parameters 

None. 

command 

qualifier 

/EDIT 

Indicates that the EDT editor is invoked. You can use the EDT editor to 
easily peruse the next message. When you are done, enter the EDT command 
QUIT. You will see the mail prompt. If you decide to edit the message and 
want to keep a copy of the newly edited message, enter the EDT command 
EXIT and supply a file name. 
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MAIL 

PRINT 


PRINT 

Queues a copy of the message you are currently reading (or have 
just read) for printing. The file(s) created by the PRINT command are 
not actually released to the print queue until you exit from MAIL, so 
that multiple messages will be concatenated into one print job. 

FORMAT 

PRINT 

command 

parameters 

None. 

command 

qualifiers 

/ALL 

Indicates that all the currently selected messages be printed. 

/COPIES=n 

Indicates the number of copies to be printed. 

/NOTIFY 

Indicates that you will be notified by a broadcast message when the file or 
files have been printed. 

/PRINT 

Releases all messages previously queued with the PRINT command to the 
print queue. If you do not specify the /PRINT qualifier, messages are not 
released to the print queue until you exit from MAIL. PRINT/PRINT will not 
queue the current message for printing. Also note that the only other qualifier 
you can specify with /PRINT is /NOTIFY. 

/QUE UE=queue-name 

The name of the queue to which a message is to be sent. If the /QUEUE 
qualifier is not specified, the message is queued to the SYS$PRINT printer. 

If you enter the PRINT command more than once specifying a different 
queue-name, any previously queued messages are released to the print queue. 


EXAMPLES 

Q MAIL> 5 

MAIL> PRINT/QUEUE=LMNO 
MAIL> EXIT 

Job MAIL (queue MARS.PRINT, entry 333) started on QUEUE$LPAO 

$ 


This example shows how to print message number 5 on printer LMNO. 












MAIL 

PRINT 


0 MAIL> PRINT/PRINT 

%MAIL-E-NOMSGPRI, no messages printed 


MAIL> 14 
MAIL> print 
MAIL> 23 
mail> PRINT 
mail> print/print 

Job MAIL (queue QUASAR.PRINT. entry 333) started on QUEUE$LPAO 

The first part of this example shows how MAIL displays an error message 
when you issue the /PRINT qualifier before you use the PRINT command 
alone. The second part shows how to release mail messages (14 and 23) to 
the print queue by entering the /PRINT qualifier. 

0 MAIL> 2 

mail> PRINT 
MAIL> 7 

mail> print 

MAIL> 9 

MAIL> PRINT/QUEUE=LMNO 

Job MAIL (queue WRITERS_PRINT, entry 148) started on QUEUE$LPAO 
MAIL> 24 
mail> PRINT 
MAIL> 31 

MAIL> PRINT/QUEUE=LMRT 

Job MAIL (queue WRITERS.PRINT, entry 149) started on QUEUE$LPAO 

This example shows how mail messages are released to the print queue when 
you use the /QUEUE qualifier. 
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MAIL 

PURGE 


PURGE 

Deletes all the messages in the WASTEBASKET folder. When you 
EXIT from MAIL or issue a SET FILE command (to select a new mail 
file), an implicit PURGE is done to empty the WASTEBASKET folder. 

Purged message space is not available for reuse by VAX Record 
Management Services (RMS) until you enter the PURGE/RECLAIM 
command. An automatic PURGE/RECLAIM is done when the 
amount of deleted space in a mail file exceeds 32,767 bytes. (MAIL 
uses the CONVERT/RECLAIM utility to reclaim space.) 

FORMAT 

PURGE 

command 

parameters 

None. 

command 

qualifiers 

/RECLAIM 

Releases deleted message space back to VAX Record Management Services 
(RMS) for reuse. 

Because your mail file is locked while PURGE/RECLAIM is running, you 
will be unable to receive new mail. Users attempting to send you mail while 
PURGE/RECLAIM is running will receive an error message indicating that 
their message was not sent successfully. 

/STATISTICS 

Indicates the amount of released deleted message space in a short statistics 
display when you use it with PURGE/RECLAIM. 

EXAMPLES 


□ MAIL> PURGE/RECLAIM 

MAIL> 

This example shows how to enter the PURGE/RECLAIM command to 
delete all the messages in the WASTEBASKET folder and release the deleted 


message space back to VAX Record Management Services (RMS) for reuse. 

0 MAIL> PURGE/RECLAIM/STATISTICS 
Reclaim Statistics: 

Data buckets scanned: 1 

Data buckets reclaimed: 0 
Index buckets reclaimed: 0 
Total buckets reclaimed: 0 

MAIL> 

This example shows the kind of information that the /STATISTICS qualifier 
displays about the reclaimed deleted message space. 
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QUIT 


QUIT 

Exits you from MAIL without emptying the WASTEBASKET folder. 
QUIT performs the same function as CTRL/Y. 

FORMAT 

QUIT 

command 

parameters 

None. 

command 

qualifiers 

None. 


EXAMPLE 

MAIL> 2 
MAIL:* DELETE 
MAIL> 6 
MAIL> DELETE 
MAIL> quit 
$ MAIL 

MAIL> SELECT WASTEBASKET 

•/.MAIL-1-SELECTED, 2 messages selected 

mail> directory 


# From Date 

1 FRANCO 20-APR-85 

2 ZEUS 22-APR-85 

WASTEBASKET 

Subj ect 

Swiss Chocolates 

Austrian Pastry 

This example shows how to use the QUIT command to avoid emptying the 
WASTEBASKET folder. 
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READ 


READ 



Displays your messages. It can be issued with or without parame¬ 
ters. 

Pressing the RETURN key is the same as entering the READ com¬ 
mand without parameters. If you issue the READ command without 
parameters or press RETURN immediatedly after MAIL is invoked, 
MAIL displays the first page of your oldest unread message in your 
NEWMAIL folder. If there are no unread messages, MAIL displays 
the oldest message in the MAIL folder. Each time you enter the 
READ command without parameters, or press RETURN, MAIL dis¬ 
plays the next page, or the next message if there are no more pages 
in the current message. 

If a new message arrives while you are in MAIL, you can enter 
READ/NEW to read the message, and then return to the previous 
MAIL activity. 

Note that every time you use /BEFORE, /NEW, or /SINCE, you 
create a new set of selected messages. 

FORMAT 

READ [foldername] [message-number] 

command 

parameters 

foldername 

Indicates the name of the folder containing the messages to be read. If a 
folder name is specified, MAIL displays messages from that folder. If no 
folder name is specified, MAIL displays messages from the current folder. 

message-number 

Indicates the number of the message to be read. The message number 
represents the position of a message in a folder. If you specify a number 
greater than the number of messages in the folder, MAIL displays the last 
message in the folder. Therefore, to read the latest message in a folder, 
specify a large message number or enter the LAST command. 

command 

qualifiers 

/BEFORE=date 

Displays mail messages received before the specified date. If no date is 
specified, all the mail messages received before the current day ("today" ) are 
displayed. 

/EDIT 

Indicates that the EDT editor is invoked. You can use the EDT editor to 
easily peruse the next message. When you are done, enter the EDT command 
QUIT. You will see the mail prompt. If you decide to edit the message and 
want to keep a copy of the newly edited message, enter the EDT command 
EXIT and supply a file name. 

/NEW 

Displays new mail messages received while you are in MAIL. If there are no 
new messages, the message "No new messages" will be printed. 
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READ 


/SINCE=date 

Displays mail messages received on or after the specified date. If no date is 
specified, all the mail messages received after the current day ("today" ) are 
displayed. 


EXAMPLES 

Q MAIL> READ/BEFORE=16-MAY 

This example shows how to use the /BEFORE qualifier with the READ 
command to display all the mail messages in the current folder received 
before May 16, 1985. 

0 MAIL> READ/SINCE=13-0CT 

This example shows how to use the /SINCE qualifier with the READ com¬ 
mand to display all the mail messages in the current folder received on or 
after October 13, 1985. 

0 MAIL> READ/NEW 

This example shows how to read new mail received while you are in MAIL. 
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REPLY 


REPLY 



Sends a message to the sender of the message you are currently 
reading or the one you last read. If you do not specify the name 
of a file to be sent as your reply, you will be prompted for the text 
of your reply. You can use the REPLY command and the ANSWER 
command interchangeably because they work the same way. 

You must be reading a message in order to reply to it. 

If you change your mind about replying to a message after you have 
already entered the REPLY command, enter CTRL/C to abort the 
message. The MAIL> prompt will be displayed. 

FORMAT 

REPLY [file-spec] 

command 

parameter 

file-spec 

Indicates the name of the file to be sent as a reply. 

command 

qualifiers 

/[NOJEDIT 

Invokes the EDT editor to edit the reply you are sending. When you EXIT 
from EDT, the edited message is sent. To cancel the sending of the mes¬ 
sage, enter the EDT command QUIT. If you enter the DCL command 
MAIL/EDIT=(REPLY) and then decide that you do not want to invoke 
the editor for your response, enter the MAIL command REPLY/NOEDIT. 

/EXTRACT 

Invokes the EDT Editor to enable you to edit the current message to which 
you are replying. 

/LAST 

Specifies that the last message you sent be used as text for the reply. You 
cannot use /LAST in conjuction with other qualifiers or a file specification. 

/[NOJSELF 

Determines whether MAIL sends a copy of the response back to you. The 
default is /NOSELF, unless you have used the SET COPY_SELF command 
to specify that copies be sent to yourself automatically. 
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MAIL 

REPLY 


EXAMPLES 

□ MAIL> REPLY/EXTRACT 
To: FLAXEN::STARCK 
Subj: RE:Verbosity 

This text was mailed to a user named Starck. 
[EOB] 


* EXIT 

DISKS:[STARCK]MAIL.TMP;1 17 lines 
MAIL> 


This example shows how to use the /EXTRACT qualifier to edit your response to a user named Starck 
on node FLAXEN before sending it. 

0 MAIL> REPLY/SELF 

To: FLAME::CORSTAN, HOWE 
Subj: RE: Ecology 

Enter your message below. Press CTRL/Z when complete, 

CTRL/C to quit: 


I CTRL/Z | 

New mail on node MARBLE from HOWE 

This example shows how a user named HOWE on node MARBLE replies to a 
user named CORSTAN on node FLAME. The /SELF qualifier enables MAIL 
to return a copy of the reply back to HOWE. 
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SEARCH 

Searches the currently selected folder for the message containing 
the first occurrence of the specified text string. 

FORMAT 

SEARCH search-string 

command 

parameter 

[search-string] 

Indicates the text string that MAIL searches for in the currently selected 
messages. The search starts from the beginning of the messages in the current 
folder. If a "search-string" is not specified, a search is made for the previously 
specified string, starting after the message you are currently reading (or have 
just read). 

command 

qualifiers 

None. 


EXAMPLE 

MAIL> SEARCH under the 

From: BURT 

To: ANTON 

Subj: Coal Mines 

They commute under the earth... 

MAIL> 

This example shows how to search for the string "under the." 
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SELECT 


SELECT 



Establishes a set of messages that you can affect as a group. You 
can COPY or MOVE selected messages from one folder to another. 
Or, you can READ and DELETE, or SEARCH and EXTRACT a set of 
messages. After you SELECT a set of messages, you can use the 
following commands to affect them: 

COPY 

DELETE 

DIRECTORY 

EXTRACT 

FILE 

MOVE 

READ 

SEARCH 

You can also use the SELECT command to move from one folder to 
another. 

If you select a folder that does not exist, MAIL displays the following 
message: 

%MAIL-E-NOTEXIST, folder foldername does not exist 

FORMAT 

SELECT [foldername] 

command 

parameter 

foldername 

The name of the folder to be selected. If no folder name is specified, the 
folder with the same name as the mail file is selected. 

command 

qualifiers 

/BEFORE=date 

Indicates that messages dated before the specified date be selected. If no date 
is specified, all the messages received before the current day ("today" ) are 
selected. 

/NEW 

Indicates that new (unread) messages be selected. When a mail file other than 
your default mail file is open, MAIL closes the file and opens your default 
mail file. 

/SINCE=date 

Indicates that messages dated after the specified date be selected. If no date is 
specified, all the messages received on the current day ("today" ) are selected. 
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SELECT 


EXAMPLES 


D MAIL> DIRECTORY/FOLDERS O 

MAIL NEWMAIL 

WASTEBASKET 

MAIL> SELECT WASTEBASKET © 


'/.MAIL-1-SELECTED, 3 messages selected 


MAIL> DIRECTORY © 


WASTEBASKET 


# 

From 

Date 

Subj ect 

1 

GORK 

19-APR-85 

Venus Fly Traps 

2 

GORK 

21-APR-85 

The Aloe 

3 

BURT 

22-APR-85 

Scales 


O Enter the DIRECTORY/FOLDERS command to display all currently 
existing folders. 

© Enter the SELECT command to move to the WASTEBASKET folder. 

© Enter the DIRECTORY command to display the contents of the WASTE¬ 
BASKET folder. 


This example shows how to use the SELECT command to move from the 
MAIL folder to the WASTEBASKET folder. 

E MAIL> SELECT/BEF0RE=12-APR-85 

'/.MAIL-1-SELECTED, 2 messages selected 
MAIL> DIRECTORY 

# From Date Subject 

1 MART 10-APR-85 Food 

2 BART ll-APR-85 Soup 

This example shows how to display all the mail messages received before 
April 12, 1985. 

B MAIL> SELECT/NEW 


This example shows how to select all the new (unread) mail messages. 
Because NEWMAIL is the implied folder name, you do not need to specify a 
folder name. 
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SEND 


SEND 



Sends a message to another user(s). You can use the SEND com¬ 
mand and the MAIL command interchangeably because they work 
the same way. 

MAIL prompts you first for the name of the user(s) to receive the 
message. You reply with the user name(s) or with the file name of a 
distribution list file, in the following format: 

[ [nodename: : ] username , . . . ] [. ] [Olistname] 

The distribution list file name must be the last item in the command 
string. 

Next, MAIL prompts you for the subject of the mail. To avoid the 
"Subj:" prompt, specify the /SUBJECT qualifier with the SEND 
command. 

You can include a file specification with the SEND command. If you 
specify a file with the SEND command, the text in that file is sent to 
the specified user(s). If you do not specify a file, MAIL prompts you 
for the text of your message. 

Enter the message that you want to send, then press CTRL/Z. Note 
that once you have typed a line and pressed RETURN, there is no 
way to edit it. If you decide not to send a message you are typing 
but want to stay within the Mail Utility, press CTRL/C to abort the 
message. You will then receive the MAIL> prompt. CTRL/Y exits 
you from MAIL. 

FORMAT 

SEND [file-spec] 

command 

parameter 

file-spec 

Indicates the name of the file to be sent. 

command 

qualifiers 

/[NOJEDIT 

Determines whether the EDT editor is invoked to edit the message you are 
sending. The /NOEDIT qualifier overrides the SEND/EDIT default if you 
entered the DCL command MAIL/EDIT. 

If you are interrupted while editing a mail message, a journal file is created 
containing your edits. To recover your edits, enter the following command 
line. (You may substitute another word of your choice for the word OOPS.) 

$ EDIT/RECOVER/JOURNAL=SYS$SCRATCH:MAIL.JOU SYS$SCRATCH:OOPS.TMP 

The editor is invoked displaying the text of the message you were editing. 
After you exit from the editor, you can mail the file (in this case, OOPS.TMP) 
by using the MAIL command SEND, as follows: 

MAIL> SEND OOPS.TMP 

To: MCNALLY 

Subject: Vacationing in Venice 
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SEND 


/LAST 

Specifies that the last message that you sent be used as the text for the 
message you are currently sending. You cannot use /LAST in conjuction with 
other qualifiers or a file specification. 

/[NO]SELF 

Determines whether MAIL sends a copy of the message you are sending back 
to yourself. The /NOSELF qualifier overrides the SET COPY-SELF SEND 
command. 

/SUBJECTS"subject-text" 

Specifies the subject of the mail message to be sent. 


EXAMPLES 

□ MAIL> SEND/LAST 

To: FLIGHT::MYERS 

Subj: Geometric Concepts 

MAIL> 


This example shows how to send a copy of the last mail message you sent to 
a user named Myers on node FLIGHT. 

B MAIL> SEND/SELF/SUBJECT="Good Harbor" 

To: DAPPER::WAYNE 

Enter your message below. Press CTRL/Z when complete, CTRL/C to quit: 

This example shows how to send a mail message to a user named Wayne on 
node DAPPER. The /SELF qualifier enables MAIL to send a copy of the same 
message back to you. The subject of the message is Good Harbor. 

0 MAIL> SEND 

To: BAKER,MARSTON,©SUPERVISORS 
Subject: Handling Stress 

Enter your message below. Press CTRL/Z when complete, CTRL/C to quit: 

This example shows how to send a mail message to two users (BAKER and 
MARSTON) and a distribution list (SUPERVISORS). 

Q MAIL> SEND/EDIT 
To: WAMPUS 

Subject: Duck Activities 


I CTRL/Y | 


$ EDIT/RECOVER/JOURNAL=SYS$SCRATCH:MAIL.JOU SYS$SCRATCH:DUCK.TMP 


Command: EXIT 

DISK$WRITERS:[FLYNN]DUCK.TMP;1 14 lines 

$ MAIL 

MAIL> SEND DUCK.TMP 
To: WAMPUS 

Subject: Duck Activities 

This example shows how a user named FLYNN recovers an editing session 
after being interrupted by CTRL/Y. A temporary file named DUCK.TMP is 
created, which user FLYNN then sends to a user named WAMPUS. 
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SET/SHOW [NO]AUTO_PURGE 


SET/SHOW [NO]AUTO_PURGE 

Determines whether MAIL empties the WASTEBASKET folder when 



you enter the EXIT or SET FILE command. When you use the SET 
NOAUTO_PURGE command, you must enter the PURGE command 
periodically to delete the messages in the WASTEBASKET folder. 

The default you establish with the SET AUTO—PURGE command re¬ 
mains in effect until you enter the SET NOAUTO—PURGE command. 

The SHOW AUTO_PURGE command indicates whether you have 
used the SET AUTO_PURGE command. 

FORMAT 

SET [NO]AUTO_PURGE 

SHOW AUTO_PURGE 

command 

parameters 

command 

qualifiers 

None. 

None. 


EXAMPLE 

MAIL> SET AUTO.PURGE 
MAIL> SHOW AUTO.PURGE 

Automatic deleted message purge is enabled 

This example shows how to use the SET AUTO—PURGE command to 
enable MAIL to delete the messages in the WASTEBASKET folder every 
time you enter the EXIT command or the SET FILE command. The SHOW 
AUTO—PURGE command displays whether automatic purging is enabled. 


MAIL-66 











MAIL 

SET/SHOW COPY-SELF 


SET/SHOW COPY-SELF 

Sets the default for determining whether the SEND or REPLY com- 



mands return to the sender a copy of the message being sent. 

By specifying NOSEND or NOREPLY with the SET COPY-SELF 
command, you can clear any default copying you have established 
with the SET COPY-SELF command. 

The SHOW COPY—SELF command displays the established copying. 

FORMAT 

S ET C O PY_S E LF command [, command] 

SHOW COPY-SELF 

command 

parameter 

command 

The "command" parameter can be any one of the following: SEND, 
NOSEND, REPLY, NOREPLY. You can use NOSEND and NOREPLY to 
reverse previous settings of SEND and REPLY, respectively. 

command 

qualifiers 

None. 


EXAMPLES 

Q MAIL> SHOW COPY.SELF 

Automatic copies to yourself are disabled 

This example shows the message MAIL displays when you have not used 
the SET COPY-SELF command and you enter the SHOW COPY—SELF 
command. 

0 MAIL> SET COPY.SELF SEND 
MAIL> SHOW COPY.SELF 
Automatic copy to yourself on SEND 

This example shows how to use the SET COPY—SELF command to enable 
copies of mail messages you SEND to be returned back to you. The SHOW 
COPY—SELF command indicates that you have enabled automatic copying. 
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SET/SHOW FILE 


SET/SHOW FILE 

Establishes (or opens) another file as the current mail file. By default. 



your mail file is MAIL.MAI. If you use the COPY command, the FILE 
command, or the MOVE command to create other mail files (for 
example, JOKES.MAI or HISTORY.MAI), you can then use the SET 
FILE command to open the MAIL files. 

When you enter the SET FILE command, the WASTEBASKET folder 
of the current mail file is emptied, the file is closed, and the specified 
(alternate) file is opened. 

The SHOW FILE command displays the name of the mail file that is 
currently open. 

FORMAT 

SET FILE filename 

SHOW FILE 

command 

parameter 

filename 

Indicates the name of the mail file you are opening. 

command 

qualifiers 

None. 


EXAMPLE 

mail> SHOW file 
DISKS:[ARAS]MAIL.MAI; 2 
MAIL> COPY 
.Folder: LIMERICKS 
.FILE: JOKES 

Folder LIMERICKS does not exist. 

Do you want to create it (Y/N. default is N)? y 
%MAIL-S-CREATED, DISKS:[ARAS]JOKES.MAI;1 created 
'/♦MAIL-1-NEWFOLDER, folder LIMERICKS created 

mail> SET FILE JOKES 
mail> SHOW FILE 


DISKS:[ARAS]JOKES.MAI 

This example demonstrates how the SHOW FILE command displays the 
name of the mail file that is currently open (MAIL.MAI); the COPY command 
creates a new folder (LIMERICKS) and a new mail file (JOKES); and the SET 
FILE command opens the mail file named JOKES.MAI. 
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SET/SHOW FOLDER 


SET/SHOW FOLDER 

Establishes a set of messages that you can affect as a group. You 



can COPY or MOVE this set of messages from one folder to another. 
Or, you can READ and DELETE, or SEARCH and EXTRACT a set of 
messages. After you enter the SET FOLDER command, selecting 
a set of messages, you can use the following commands to affect 
them: 

COPY 

DELETE 

DIRECTORY 

EXTRACT 

FILE 

MOVE 

READ 

SEARCH 

You can also use the SET FOLDER command to move from one 
folder to another. If you use the SET FOLDER command to move to 
a folder that does not exist, MAIL displays the following message: 

%MAIL-E-NOTEXIST, folder foldername does not exist 

The SHOW FOLDER command displays the current folder name. 

FORMAT 

SET FOLDER [foldername] 

command 

parameter 

foldername 

The name of the folder to be selected. If no folder name is specified, the 
folder with the same name as the mail file is selected. 

command 

qualifiers 

/BEFORE=date 

Indicates that messages dated before the specified date be selected. If no date 
is specified, all the messages received before the current day ("today" ) are 
selected. 

/NEW 

Indicates that new (unread) messages be selected. When a mail file other than 
your default mail file is open, MAIL closes the file and opens your default 
mail file. 

/SINCE=date 

Indicates that messages dated after the specified date be selected. If no date is 
specified, all the messages received on the current day ("today" ) are selected. 
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MAIL 

SET/SHOW FOLDER 


EXAMPLES 

D MAIL> DIRECTORY/FOLDERS O 

MAIL NEWMAIL 

WASTEBASKET 

MAIL> SET FOLDER WASTEBASKET © 


%MAIL-I-SELECTED, 3 messages selected 


MAIL> DIRECTORY © 


WASTEBASKET 


# 

From 

Date 

Subj ect 

1 

GORK 

19-APR-85 

Venus Fly Traps 

2 

GORK 

21-APR-85 

The Aloe 

3 

BURT 

22-APR-85 

Scales 


O Enter the DIRECTORY/FOLDERS command to display all currently 
existing folders. 

© Enter the SET FOLDER command to move to the WASTEBASKET folder. 

© Enter the DIRECTORY command to display the contents of the WASTE¬ 
BASKET folder. 

This example shows how to use the SET FOLDER command to move from 
the MAIL folder to the WASTEBASKET folder. 

0 MAIL> SET FOLDER/BEFORE=12-APR-85 

%MAIL-I-SELECTED, 2 messages selected 
MAIL> DIRECTORY 


# 

From 

Date 

Subj ect 

1 

MART 

10-APR-85 

Food 

2 

BART 

11-APR-85 

Soup 


This example shows how to display all the mail messages received before 
April 12, 1985. 

0 MAIL> SET FOLDER/NEW 

This example shows how to select all the new (unread) mail messages. 
Because NEWMAIL is the implied folder name, you do not need to specify a 
folder name. 
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SET/SHOW FORWARD 


SET/SHOW FORWARD 

Sets a forwarding address for your mail. After you enter the SET 



FORWARD command, the address you specify will receive mail 
messages. 

The default you establish with the SET FORWARD command re¬ 
mains in effect until you enter the SET NOFORWARD command. 

The SHOW FORWARD command displays the name of the specified 
forwarding address. 

If you have SYSNAM privilege, you can set and show forwarding 
addresses for other users. 

FORMAT 

SET [NO]FORWARD address 

command 

parameter 

address 

Indicates the address (NODE::NAME) to which your mail is forwarded. 

command 

qualifier 

[/USER=user-name] 

Indicates the name of another user for whom you are setting or showing 
a forwarding address. You can use the /USER qualifier only if you have 
SYSNAM privilege. 

EXAMPLE 


MAIL> SET FORWARD 

NEXUS::LARS 


MAIL> SHOW FORWARD 

Your mail is being forwarded to NEXUS::LARS 
MAIL> 

This example shows how a user named LARS establishes a forwarding 
address on node NEXUS with the SET FORWARD command, and displays 
the forwarding address with the SHOW FORWARD command. 
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SET/SHOW MAII_DIRECTORY 

Specifies that all MAI files be moved from your SYS$LOGIN: direc- 



tory to the specified subdirectory. 

The SET NOMAII_DIRECTORY command specifies that all MAI 

files be moved from the subdirectory back to your SYSSLOGIN: 
directory. 

The SHOW MAII_DIRECTORY command displays the name of the 

device and directory containing all your MAI files. 

FORMAT 

SET MAII_DIRECTORY [.subdirectory-name] 

command 

parameter 

[. subdirectory-name] 

Specifies the name of the subdirectory in your SYSSLOGIN: directory to 
which all MAI files are to be moved. 

command 

qualifier 

/LOG 

Displays a listing of the MAI files moved from the previous directory to the 
specified subdirectory. 


EXAMPLE 

$ SHOW TRANSLATION SYS$LOGIN 

SYSSLOGIN = "DISK$:[DALTON]" (LNM$PROCESS_TABLE) 

MAIL> SHOW MAIL.DIRECTORY 

Your mail file directory is DISKS:[DALTON] 

MA IL > SET MAIL.DIRECTORY [.MAIL] 

‘/.MAIL-1-CREATED, DISKS: [DALTON.MAIL] created 
MAIL> SHOW MAIL.DIRECTORY 

Your mail file directory is DISKS:[DALTON.MAIL] 

$ SET DEFAULT [DALTON.MAIL] 

$ DIRECTORY 

This example shows how to create a subdirectory containing all your MAI 
files. (The DCL command SHOW TRANSLATION displays the logical name 
for your default top-level directory, SYS$LOGIN:.) 
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SET/SHOW [NO]PERSONAI_NAME 


SET/SHOW [NO]PERSOI\IAI_NAME 

Enables you to append a field to the end of the "From:" field of mail 



messages you send. You can fill this field with your full name or any 
other information. 

The SET NOPERSONAI_NAME command clears any name you 

previously specified with the SET PERSONAI_NAME command. 

The SHOW PERSONAI_NAME command displays your personal 

name. 

FORMAT 

SET [NO]PERSONAI_NAME "text-string" 

command 

parameter 

"text-string" 

Specifies the string for the "From:" field of mail messages you send. You 
must enclose the string in quotation marks; otherwise, MAIL converts it to 
uppercase letters. You must begin the string with an alphanumeric character 
and avoid two consecutive embedded spaces within the string. The length of 
the "text-string" should not exceed 127 characters. 

command 

qualifier 

/USER=name 

Used with the SHOW PERSONAI_NAME command to allow a user with 
SYSNAM privilege to see personal names set by other users. 


EXAMPLE 

MAIL> SET PERSONAL_NAME "Catherine the Great” 

MAIL> SEND 

New mail on node FLAXEN from ALPHA::BELLINI "Catherine the Great" 

From: ALPHA::BELLINI "Catherine the Great" 19-APR-85 15:34 
To: FLAXEN::STARCK 

This example shows how a user named Bellini sets her personal name to 
Catherine the Great. 
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SET/SHOW WASTEBASKET_NAME 


SET/SHOW WASTEBASKET_NAME 

Enables you to change the name of the WASTEBASKET folder. The 



WASTEBASKET folder contains messages selected to be deleted. 
You can delete all the messages in the WASTEBASKET folder 
by entering either the PURGE or EXIT command. You can avoid 
deleting messages in the WASTEBASKET folder by entering the 
QUIT command. 

When you change the name of a WASTEBASKET folder while it 
contains deleted messages, these deleted messages move to the 
newly named WASTEBASKET folder. 

The SHOW WASTEBASKET_NAME command displays the name 
of the WASTEBASKET folder. 

FORMAT 

SET WASTEBASKET_NAME foldername 

SHOW WASTEBASKET.NAME 

command 

parameter 

foldername 

Indicates the name that replaces the name WASTEBASKET for the folder 
containing deleted messages. You can use any alphanumeric string for the 
new WASTEBASKET folder name except MAIL or NEWMAIL. 

command 

qualifiers 

None. 


EXAMPLE 

MAIL> SET WASTEBASKET.NAME GARBAGE 
MAIL> SHOW WASTEBASKET.NAME 
The wastebasket folder name is GARBAGE 
MAIL> 

This example shows how to change and display the name of the WASTEBAS¬ 
KET folder. 


MAIL-74 















MAIL 

SHOW ALL 

SHOW ALL 

Displays detailed information about the state of MAIL. 

FORMAT 

SHOW ALL 

command 

parameters 

None. 

command 

qualifiers 

None. 


EXAMPLE 


MAIL> SHOW ALL 

Your mail file directory is DISK:[SIMPSON]. 

Your current mail file is DISK$DOCUMENT:[SIMPSON.NEWMAIL]MAIL.MAI;1. 

Your current mail folder is MAIL. 

The wastebasket folder name is GARBAGE. 

Mail file DISK$DOCUMENT:[SIMPSON.NEWMAIL]MAIL.MAI;1 
contains 0 deleted message bytes. 

You have 3 new messages. 

You have not set a forwarding address. 

Your personal name is "Louise Simpson". 

Automatic copies to yourself are disabled. 

Automatic deleted message purge is enabled. 

This example shows how a user named Louise Simpson has entered the 
SHOW ALL command to display the following information about MAIL: 

• The name of her mail file directory 

• The current mail file and folder 

• The name of the WASTEBASKET folder (see the SET WASTEBAS¬ 
KET—NAME command) 

• The amount of deleted message space 

• The number of any new (unread) messages 

• Her forwarding address, if set (see the SET FORWARD command) 

• Her personal name, if set (see the SET PERSONAL-NAME command) 

• Whether she will receive copies of mail messages when she uses SEND or 
ANSWER (see the SET COPY-SELF command) 

• Whether MAIL empties the WASTEBASKET folder when she uses EXIT or 
SET FILE (see the SET AUTO-PURGE command) 
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MAIL 

SHOW DELETED 


SHOW DELETED 



Displays the amount of deleted message space in the current mail 
file. 

FORMAT 

SHOW DELETED 

command 

parameters 

None. 

command 

qualifiers 

None. 


EXAMPLE 

MAIL> SHOW DELETED 

Mail file DISK$NOE:[TORTELLINI.NEWMAIL]MAIL.MAI;1 
contains 2452 deleted message bytes. 

This example shows how a user named TORTELLINI displays the number of 
deleted message bytes. 
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MAIL 

SHOW KEY 


SHOW KEY 



Displays the key definitions created by the DEFINE/KEY command. 

FORMAT 

SHOW KEY [key-name] 

command 

parameter 

key-name 

Specifies the name of the key whose definition you want displayed. See the 
DEFINE/KEY command for a list of the valid key names. 

command 

qualifiers 

/ALL 

Displays all the key definitions in the specified state or states. You do not 
need to specify a keyname. 

/BRIEF 

Displays only the key definition. By default, you see all the qualifiers asso¬ 
ciated with the key definition, including any specified state, unless you use 
/BRIEF. 

/DIRECTORY 

Displays the names of all the states for which keys have been defined. If you 
have not defined any keys, SHOW KEY/DIRECTORY displays the DEFAULT 
and GOLD states (for the default and GOLD key definitions on the MAIL 
keypad). 

/STA TE=(state, state ,.. 

Specifies the name of a state for which the specified key definition(s) are to 
be displayed. If you specify two or more state names, separate them with 
commas and enclose the list in parentheses. 


EXAMPLES 

Q MAIL> SHOW KEY PF4 

DEFAULT keypad definitions: 

PF4 = "read " (echo.terminate) 

This example shows how to use the SHOW KEY command to display the 
definition of the PF4 key. When the PF4 key was defined, two qualifiers 
(/ECHO and /TERMINATE) were specified. 

Q MAIL> SHOW KEY/ALL 

DEFAULT keypad definitions: 

PF1 = "directory " (echo.state = FOLDER) 

PF2 = "HELP" (echo,terminate) 

PF3 = "select " (echo.terminate) 

PF4 = "read " (echo.terminate) 

KPO = "NEXT" (echo.terminate) 

This example shows how to use the SHOW KEY command to display all the 
key definitions you have created with the DEFINE/KEY command. 
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SHOW NEW—MAII_COUNT 



Displays the number of unread mail messages. 

FORMAT 

SHOW NEW_MAII_COUNT 

command 

parameters 

None. 

command 

qualifiers 

None. 

EXAMPLE 


MAIL> SHOW NEW_MAIL_COUNT 
You have 0 new messages. 

This example shows how the SHOW NEW_MAIL_COUNT command 
displays the number of unread mail messages, in this case, zero. 
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MAIL 

SPAWN 


SPAWN 



Creates a subprocess of the current process. The context of the 
subprocess is copied from the current process. You can use the 
SPAWN command to leave MAIL temporarily, perform other func¬ 
tions (such as displaying a directory listing or printing a file), and 
then return to MAIL. 

FORMAT 

SPAWN [command] 

command 

parameter 

command 

Specifies the DCL command string that executes in the context of the created 
subprocess. When the command completes, the subprocess terminates and 
control is returned to the parent process. If not specified, a subprocess is 
created transferring control to the DCL command level. 

command 

qualifiers 

/INPUT=file-spec 

Specifies an input file containing one or more DCL command strings to be 
executed by the spawned subprocess. If you specify a command string along 
with an input file, the command string is processed before the commands in 
the input file. Once processing is complete, the subprocess is terminated. 

/LOGICAL-NAMES 

Specifies that the logical names of the parent process be copied to the sub¬ 
process. When you do not want the subprocess to use the logical names of 
the parent process, enter the qualifier /NOLOGICAL—NAMES. The default is 
/LOGICAL_NAMES. 

/OUTPUT=file-spec 

Identifies the output file to which the results of the SPAWN operation are 
written. You should specify an output other than SYS$OUTPUT whenever 
you specify /NOWAIT to prevent output from being displayed while you 
are specifying new commands. If you omit the /OUTPUT qualifier, output is 
written to the current SYS$OUTPUT device. 

/PROCESS=subprocess-name 

Specifies the name of the subprocess to be created. The default name of the 
subprocess is USERNAME_n. 

/[NOJSYMBOLS 

Determines whether the system passes DCL global and local symbols to the 
subprocess. The default is /SYMBOLS. 

/WAIT 

Controls whether the system waits until the subprocess is completed before 
allowing more commands to be specified. The /NOWAIT qualifier allows 
you to specify new commands while the specified subprocess is running. If 
you specify /NOWAIT, you should also use /OUTPUT to direct the output to 
a file (rather than displaying it on the screen) to prevent your terminal from 
being used by more than one process simultaneously. 
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MAIL 

SPAWN 


EXAMPLES 

Q MAIL> SPAWN SHOW TIME 


This example shows how to create a subprocess that will execute the DCL 
command SHOW TIME while you are in MAIL. 

0 MAIL> SPAWN PHONE 


% EXIT 

MAIL> 


This example shows how to create a subprocess that invokes the VAX/VMS 
Phone Utility while you are in MAIL. When you EXIT from PHONE, the 
subprocess disappears and the MAIL prompt returns. 

0 MAIL> SPAWN DIRECTORY 


MAIL> 


This example shows how to create a subprocess to invoke the DCL command 
DIRECTORY. 

Q MAIL> SPAWN /OUTPUT=TIME.DAT SHOW TIME 
MAIL> EXIT 
$ TYPE TIME.DAT 

9-MAY-1985 15:34:07 

$ 


This example shows how to create a subprocess to invoke the SHOW TIME 
command while you are in MAIL. The /OUTPUT qualifier specifies that the 
file TIME.DAT contain the results of the SHOW TIME command. 

0 MAIL> SPAWN /NOLOGICAL.NAMES SET HOST 
_Node: MARS 


$ LOGOUT 

CRAMMER logged out at ... 

•/.REM-S-END, control returned to node _BETA: : 
MAIL> 


This example shows how to use the SPAWN command to create a subprocess 
in which you SET HOST to another node. When you want to leave node 
MARS and move back to node BETA, enter the LOGOUT command. The 
/NOLOGICAIx—NAMES qualifier prevents the logical names of the parent 
process from being copied to the subprocess. 


MAIL—80 







MAIL 

SPAWN 


0 MAIL> SPAWN RUNOFF FILENAME.RNO 


MAIL> 

This example shows how to spawn a subprocess to enter the DCL command 
RUNOFF. While the subprocess is running, you will be unable to enter other 
commands. When the RUNOFF command completes the task, the subprocess 
disappears and the MAIL prompt returns. 

Q MAIL> SPAWN/NOWAIT/OUTPUT=LOG.DAT RUNOFF FILENAME.RNO 
MAIL> 

This example shows how to spawn a subprocess to enter the DCL command 
RUNOFF. The /NOWAIT qualifier enables you to enter other commands 
while the subprocess is running. The output file, LOG.DAT, contains in¬ 
formation about the spawn operation. (The RUNOFF command produces a 
MEM file, FILENAME.MEM.) 

0 MAIL> SPAWN STOP/ENTRY=667 SYS$BATCH 
MAIL> 

Batch job ACCOUNTING (queue SYS$BATCH, entry 667) was aborted on 

l-JUN-1985 12:52 

MAIL> 


This example shows how to create a subprocess to stop a batch job (entry 
667). 
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MAIL 

Examples 



The following examples demonstrate how to use the MAIL commands, SEND 
and READ. 


EXAMPLES 


□ $ MAIL 

MAIL> SEND 

To: BRIGHT::BRITTEN 

Subj: June Recitals 

Enter your message below. Press CTRL/Z when complete, CTRL/C to quit: 


1CTRL/Z1 


Exit 

MAIL> 



This example shows how to send a mail message to a user named Britten on 


node BRIGHT. 


£ $ MAIL 


You have 1 new message 
MAIL> read 


MAIL> 


This example shows how to read a new mail message. 
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